{
  "components": {
    "parameters": {
      "access_request_gid": {
        "description": "Globally unique identifier for the access request.",
        "example": "12345",
        "in": "path",
        "name": "access_request_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "access_request"
      },
      "agent_path_gid": {
        "description": "Globally unique identifier for the agent.",
        "example": "12345",
        "in": "path",
        "name": "agent_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "agent"
      },
      "ai_studio_division_gid": {
        "description": "Scope results to a single division (its gid). Omitted ⇒ the org's first licensed division. Use this to retrieve only one division's slice (e.g. for a division-level admin or billing owner) rather than the whole organization.",
        "in": "query",
        "name": "division_gid",
        "required": false,
        "schema": {
          "format": "id",
          "type": "string"
        }
      },
      "ai_studio_end_at": {
        "description": "Filter to runs whose usage was recorded before this time (exclusive) — by when the run's credit usage was recorded, not by `run_started_at`. Defaults to the time of the request.",
        "in": "query",
        "name": "end_at",
        "required": false,
        "schema": {
          "format": "date-time",
          "type": "string"
        }
      },
      "ai_studio_seat_state": {
        "description": "Filter seats to this state.",
        "in": "query",
        "name": "state",
        "required": false,
        "schema": {
          "enum": [
            "active",
            "revoked"
          ],
          "type": "string"
        }
      },
      "ai_studio_start_at": {
        "description": "Inclusive lower bound. Runs are ordered and filtered by when their usage was recorded (the monotonic timestamp used for incremental polling), not by `run_started_at`. Omitted ⇒ the 2025-01-08 floor — no credit data exists before then, and there is no limit on how far back you can query. A value earlier than 2025-01-08 is treated as 2025-01-08 (not rejected), matching the audit log.",
        "in": "query",
        "name": "start_at",
        "required": false,
        "schema": {
          "format": "date-time",
          "type": "string"
        }
      },
      "allocation_path_gid": {
        "description": "Globally unique identifier for the allocation.",
        "example": "77688",
        "in": "path",
        "name": "allocation_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "allocation"
      },
      "archived_query_param": {
        "description": "Only return projects whose `archived` field takes on the value of this parameter.",
        "example": false,
        "in": "query",
        "name": "archived",
        "schema": {
          "type": "boolean"
        }
      },
      "attachment_path_gid": {
        "description": "Globally unique identifier for the attachment.",
        "example": "12345",
        "in": "path",
        "name": "attachment_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "attachment"
      },
      "audit_log_actor_gid": {
        "description": "Filter to events triggered by the actor with this ID.",
        "in": "query",
        "name": "actor_gid",
        "required": false,
        "schema": {
          "type": "string"
        }
      },
      "audit_log_actor_type": {
        "description": "Filter to events with an actor of this type.\nThis only needs to be included if querying for actor types without an ID. If `actor_gid` is included, this should be excluded.",
        "in": "query",
        "name": "actor_type",
        "required": false,
        "schema": {
          "enum": [
            "user",
            "asana",
            "asana_support",
            "anonymous",
            "external_administrator"
          ],
          "type": "string"
        }
      },
      "audit_log_end_at": {
        "description": "Filter to events created before this time (exclusive).",
        "in": "query",
        "name": "end_at",
        "required": false,
        "schema": {
          "format": "date-time",
          "type": "string"
        }
      },
      "audit_log_event_type": {
        "description": "Filter to events of this type.\nRefer to the [supported audit log events](/docs/audit-log-events#supported-audit-log-events) for a full list of values.",
        "in": "query",
        "name": "event_type",
        "required": false,
        "schema": {
          "type": "string"
        }
      },
      "audit_log_resource_gid": {
        "description": "Filter to events with this resource ID.",
        "in": "query",
        "name": "resource_gid",
        "required": false,
        "schema": {
          "type": "string"
        }
      },
      "audit_log_start_at": {
        "description": "Filter to events created after this time (inclusive).",
        "in": "query",
        "name": "start_at",
        "required": false,
        "schema": {
          "format": "date-time",
          "type": "string"
        }
      },
      "budget_path_gid": {
        "description": "Globally unique identifier for the budget.",
        "example": "12345",
        "in": "path",
        "name": "budget_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "budget"
      },
      "coding_agent_session_path_gid": {
        "description": "Globally unique identifier for the Command coding agent session.",
        "example": "321654",
        "in": "path",
        "name": "session_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "session"
      },
      "completed_since": {
        "description": "Only return tasks that are either incomplete or that have been completed since this time. Accepts a date-time string or the keyword *now*.\n",
        "example": "2012-02-22T02:06:58.158Z",
        "in": "query",
        "name": "completed_since",
        "required": false,
        "schema": {
          "type": "string"
        }
      },
      "custom_field_path_gid": {
        "description": "Globally unique identifier for the custom field.",
        "example": "12345",
        "in": "path",
        "name": "custom_field_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "custom_field"
      },
      "custom_id": {
        "description": "Generated custom ID for a task.",
        "example": "EX-1",
        "in": "path",
        "name": "custom_id",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "custom_type_gid": {
        "description": "Globally unique identifier for the custom type.",
        "example": "12345",
        "in": "path",
        "name": "custom_type_gid",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "custom_type_query_param": {
        "description": "Filter results by custom type. Provide a custom type GID to return only objects of that custom type (an unknown GID returns `400`). Provide an empty string to return only objects with no custom type assigned. If this parameter is omitted, results are not filtered by custom type.",
        "example": "12345",
        "in": "query",
        "name": "custom_type",
        "required": false,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "custom_type"
      },
      "fields": {
        "description": "Defines fields to return.\nSome requests return *compact* representations of objects in order to conserve resources and complete the request more efficiently. Other times requests return more information than you may need. This option allows you to list the exact set of fields that the API should be sure to return for the objects. The field names should be provided as paths, described below.\nThe id of included objects will always be returned, regardless of the field options.\nProperties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
        "example": [
          "followers",
          "assignee"
        ],
        "explode": false,
        "in": "query",
        "name": "opt_fields",
        "required": false,
        "schema": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "style": "form"
      },
      "goal_path_gid": {
        "description": "Globally unique identifier for the goal.",
        "example": "12345",
        "in": "path",
        "name": "goal_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "goal"
      },
      "goal_relationship_path_gid": {
        "description": "Globally unique identifier for the goal relationship.",
        "example": "12345",
        "in": "path",
        "name": "goal_relationship_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "goal_relationship"
      },
      "job_path_gid": {
        "description": "Globally unique identifier for the job.",
        "example": "12345",
        "in": "path",
        "name": "job_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "job"
      },
      "limit": {
        "description": "Results per page.\nThe number of objects to return per page. The value must be between 1 and 100.",
        "example": 50,
        "in": "query",
        "name": "limit",
        "schema": {
          "maximum": 100,
          "minimum": 1,
          "type": "integer"
        }
      },
      "member": {
        "description": "Member object gid can be user or team.\n",
        "example": "123",
        "in": "query",
        "name": "member",
        "required": false,
        "schema": {
          "type": "string"
        }
      },
      "membership_path_gid": {
        "description": "Globally unique identifier for the membership.",
        "example": "12345",
        "in": "path",
        "name": "membership_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "membership"
      },
      "message_path_gid": {
        "description": "The message to get.",
        "example": "321654",
        "in": "path",
        "name": "message_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "message"
      },
      "offset": {
        "description": "Offset token.\nAn 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.\n*Note: You can only pass in an offset that was returned to you via a previously paginated request.*",
        "example": "eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9",
        "in": "query",
        "name": "offset",
        "schema": {
          "type": "string"
        }
      },
      "ooo_entry_path_gid": {
        "description": "Globally unique identifier for the OOO entry.",
        "example": "12345",
        "in": "path",
        "name": "ooo_entry_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "ooo_entry"
      },
      "organization_export_path_gid": {
        "description": "Globally unique identifier for the organization export.",
        "example": "12345",
        "in": "path",
        "name": "organization_export_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "organization_export"
      },
      "portfolio_membership_path_gid": {
        "example": "1331",
        "in": "path",
        "name": "portfolio_membership_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "portfolio_membership"
      },
      "portfolio_path_gid": {
        "description": "Globally unique identifier for the portfolio.",
        "example": "12345",
        "in": "path",
        "name": "portfolio_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "portfolio"
      },
      "portfolio_query_param": {
        "description": "The portfolio to filter results on.",
        "example": "12345",
        "in": "query",
        "name": "portfolio",
        "schema": {
          "type": "string"
        },
        "x-env-variable": "portfolio"
      },
      "pretty": {
        "allowEmptyValue": true,
        "description": "Provides “pretty” output.\nProvides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.",
        "example": true,
        "in": "query",
        "name": "opt_pretty",
        "required": false,
        "schema": {
          "type": "boolean"
        },
        "style": "form"
      },
      "project_brief_path_gid": {
        "description": "Globally unique identifier for the project brief.",
        "example": "12345",
        "in": "path",
        "name": "project_brief_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "project_brief"
      },
      "project_membership_path_gid": {
        "example": "1331",
        "in": "path",
        "name": "project_membership_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "project_membership"
      },
      "project_path_gid": {
        "description": "Globally unique identifier for the project.",
        "example": "1331",
        "in": "path",
        "name": "project_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "project"
      },
      "project_portfolio_setting_path_gid": {
        "description": "Globally unique identifier for the project portfolio setting.",
        "example": "1331",
        "in": "path",
        "name": "project_portfolio_setting_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "project_portfolio_setting"
      },
      "project_query_param": {
        "description": "Globally unique identifier for the project, used as a filter when retrieving custom types.",
        "example": "1331",
        "in": "query",
        "name": "project",
        "required": false,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "project"
      },
      "project_status_path_gid": {
        "description": "The project status update to get.",
        "example": "321654",
        "in": "path",
        "name": "project_status_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "project_status"
      },
      "project_template_path_gid": {
        "description": "Globally unique identifier for the project template.",
        "example": "1331",
        "in": "path",
        "name": "project_template_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "project_template"
      },
      "rate_path_gid": {
        "description": "Globally unique identifier for the rate.",
        "example": "12345",
        "in": "path",
        "name": "rate_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "rate"
      },
      "record_path_gid": {
        "description": "Globally unique identifier for the record.",
        "example": "7331",
        "in": "path",
        "name": "record_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "record"
      },
      "release_path_gid": {
        "description": "Globally unique identifier for the Command release.",
        "example": "987654",
        "in": "path",
        "name": "release_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "release"
      },
      "role_path_gid": {
        "description": "Globally unique identifier for the role.",
        "example": "12345",
        "in": "path",
        "name": "role_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "role"
      },
      "rule_trigger_path_gid": {
        "description": "The ID of the incoming web request trigger. This value is a path parameter that is automatically generated for the API endpoint.",
        "example": "12345",
        "in": "path",
        "name": "rule_trigger_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "rule"
      },
      "sdk__access_request_gid": {
        "description": "Globally unique identifier for the access request.",
        "example": "12345",
        "in": "path",
        "name": "access_request_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "access_request"
      },
      "sdk__agent_path_gid": {
        "description": "Globally unique identifier for the agent.",
        "example": "12345",
        "in": "path",
        "name": "agent_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "agent"
      },
      "sdk__ai_studio_division_gid": {
        "description": "Scope results to a single division (its gid). Omitted ⇒ the org's first licensed division. Use this to retrieve only one division's slice (e.g. for a division-level admin or billing owner) rather than the whole organization.",
        "in": "query",
        "name": "division_gid",
        "required": false,
        "schema": {
          "format": "id",
          "type": "string"
        }
      },
      "sdk__ai_studio_end_at": {
        "description": "Filter to runs whose usage was recorded before this time (exclusive) — by when the run's credit usage was recorded, not by `run_started_at`. Defaults to the time of the request.",
        "in": "query",
        "name": "end_at",
        "required": false,
        "schema": {
          "format": "date-time",
          "type": "string"
        }
      },
      "sdk__ai_studio_seat_state": {
        "description": "Filter seats to this state.",
        "in": "query",
        "name": "state",
        "required": false,
        "schema": {
          "enum": [
            "active",
            "revoked"
          ],
          "type": "string"
        }
      },
      "sdk__ai_studio_start_at": {
        "description": "Inclusive lower bound. Runs are ordered and filtered by when their usage was recorded (the monotonic timestamp used for incremental polling), not by `run_started_at`. Omitted ⇒ the 2025-01-08 floor — no credit data exists before then, and there is no limit on how far back you can query. A value earlier than 2025-01-08 is treated as 2025-01-08 (not rejected), matching the audit log.",
        "in": "query",
        "name": "start_at",
        "required": false,
        "schema": {
          "format": "date-time",
          "type": "string"
        }
      },
      "sdk__allocation_path_gid": {
        "description": "Globally unique identifier for the allocation.",
        "example": "77688",
        "in": "path",
        "name": "allocation_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "allocation"
      },
      "sdk__archived_query_param": {
        "description": "Only return projects whose `archived` field takes on the value of this parameter.",
        "example": false,
        "in": "query",
        "name": "archived",
        "schema": {
          "type": "boolean"
        }
      },
      "sdk__attachment_path_gid": {
        "description": "Globally unique identifier for the attachment.",
        "example": "12345",
        "in": "path",
        "name": "attachment_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "attachment"
      },
      "sdk__audit_log_actor_gid": {
        "description": "Filter to events triggered by the actor with this ID.",
        "in": "query",
        "name": "actor_gid",
        "required": false,
        "schema": {
          "type": "string"
        }
      },
      "sdk__audit_log_actor_type": {
        "description": "Filter to events with an actor of this type.\nThis only needs to be included if querying for actor types without an ID. If `actor_gid` is included, this should be excluded.",
        "in": "query",
        "name": "actor_type",
        "required": false,
        "schema": {
          "enum": [
            "user",
            "asana",
            "asana_support",
            "anonymous",
            "external_administrator"
          ],
          "type": "string"
        }
      },
      "sdk__audit_log_end_at": {
        "description": "Filter to events created before this time (exclusive).",
        "in": "query",
        "name": "end_at",
        "required": false,
        "schema": {
          "format": "date-time",
          "type": "string"
        }
      },
      "sdk__audit_log_event_type": {
        "description": "Filter to events of this type.\nRefer to the [supported audit log events](/docs/audit-log-events#supported-audit-log-events) for a full list of values.",
        "in": "query",
        "name": "event_type",
        "required": false,
        "schema": {
          "type": "string"
        }
      },
      "sdk__audit_log_resource_gid": {
        "description": "Filter to events with this resource ID.",
        "in": "query",
        "name": "resource_gid",
        "required": false,
        "schema": {
          "type": "string"
        }
      },
      "sdk__audit_log_start_at": {
        "description": "Filter to events created after this time (inclusive).",
        "in": "query",
        "name": "start_at",
        "required": false,
        "schema": {
          "format": "date-time",
          "type": "string"
        }
      },
      "sdk__budget_path_gid": {
        "description": "Globally unique identifier for the budget.",
        "example": "12345",
        "in": "path",
        "name": "budget_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "budget"
      },
      "sdk__coding_agent_session_path_gid": {
        "description": "Globally unique identifier for the Command coding agent session.",
        "example": "321654",
        "in": "path",
        "name": "session_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "session"
      },
      "sdk__completed_since": {
        "description": "Only return tasks that are either incomplete or that have been completed since this time. Accepts a date-time string or the keyword *now*.\n",
        "example": "2012-02-22T02:06:58.158Z",
        "in": "query",
        "name": "completed_since",
        "required": false,
        "schema": {
          "type": "string"
        }
      },
      "sdk__custom_field_path_gid": {
        "description": "Globally unique identifier for the custom field.",
        "example": "12345",
        "in": "path",
        "name": "custom_field_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "custom_field"
      },
      "sdk__custom_id": {
        "description": "Generated custom ID for a task.",
        "example": "EX-1",
        "in": "path",
        "name": "custom_id",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "sdk__custom_type_gid": {
        "description": "Globally unique identifier for the custom type.",
        "example": "12345",
        "in": "path",
        "name": "custom_type_gid",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "sdk__custom_type_query_param": {
        "description": "Filter results by custom type. Provide a custom type GID to return only objects of that custom type (an unknown GID returns `400`). Provide an empty string to return only objects with no custom type assigned. If this parameter is omitted, results are not filtered by custom type.",
        "example": "12345",
        "in": "query",
        "name": "custom_type",
        "required": false,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "custom_type"
      },
      "sdk__goal_path_gid": {
        "description": "Globally unique identifier for the goal.",
        "example": "12345",
        "in": "path",
        "name": "goal_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "goal"
      },
      "sdk__goal_relationship_path_gid": {
        "description": "Globally unique identifier for the goal relationship.",
        "example": "12345",
        "in": "path",
        "name": "goal_relationship_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "goal_relationship"
      },
      "sdk__job_path_gid": {
        "description": "Globally unique identifier for the job.",
        "example": "12345",
        "in": "path",
        "name": "job_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "job"
      },
      "sdk__limit": {
        "description": "Results per page.\nThe number of objects to return per page. The value must be between 1 and 100.",
        "example": 50,
        "in": "query",
        "name": "limit",
        "schema": {
          "maximum": 100,
          "minimum": 1,
          "type": "integer"
        }
      },
      "sdk__member": {
        "description": "Member object gid can be user or team.\n",
        "example": "123",
        "in": "query",
        "name": "member",
        "required": false,
        "schema": {
          "type": "string"
        }
      },
      "sdk__membership_path_gid": {
        "description": "Globally unique identifier for the membership.",
        "example": "12345",
        "in": "path",
        "name": "membership_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "membership"
      },
      "sdk__message_path_gid": {
        "description": "The message to get.",
        "example": "321654",
        "in": "path",
        "name": "message_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "message"
      },
      "sdk__offset": {
        "description": "Offset token.\nAn 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.\n*Note: You can only pass in an offset that was returned to you via a previously paginated request.*",
        "example": "eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9",
        "in": "query",
        "name": "offset",
        "schema": {
          "type": "string"
        }
      },
      "sdk__ooo_entry_path_gid": {
        "description": "Globally unique identifier for the OOO entry.",
        "example": "12345",
        "in": "path",
        "name": "ooo_entry_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "ooo_entry"
      },
      "sdk__organization_export_path_gid": {
        "description": "Globally unique identifier for the organization export.",
        "example": "12345",
        "in": "path",
        "name": "organization_export_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "organization_export"
      },
      "sdk__portfolio_membership_path_gid": {
        "example": "1331",
        "in": "path",
        "name": "portfolio_membership_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "portfolio_membership"
      },
      "sdk__portfolio_path_gid": {
        "description": "Globally unique identifier for the portfolio.",
        "example": "12345",
        "in": "path",
        "name": "portfolio_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "portfolio"
      },
      "sdk__portfolio_query_param": {
        "description": "The portfolio to filter results on.",
        "example": "12345",
        "in": "query",
        "name": "portfolio",
        "schema": {
          "type": "string"
        },
        "x-env-variable": "portfolio"
      },
      "sdk__project_brief_path_gid": {
        "description": "Globally unique identifier for the project brief.",
        "example": "12345",
        "in": "path",
        "name": "project_brief_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "project_brief"
      },
      "sdk__project_membership_path_gid": {
        "example": "1331",
        "in": "path",
        "name": "project_membership_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "project_membership"
      },
      "sdk__project_path_gid": {
        "description": "Globally unique identifier for the project.",
        "example": "1331",
        "in": "path",
        "name": "project_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "project"
      },
      "sdk__project_portfolio_setting_path_gid": {
        "description": "Globally unique identifier for the project portfolio setting.",
        "example": "1331",
        "in": "path",
        "name": "project_portfolio_setting_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "project_portfolio_setting"
      },
      "sdk__project_query_param": {
        "description": "Globally unique identifier for the project, used as a filter when retrieving custom types.",
        "example": "1331",
        "in": "query",
        "name": "project",
        "required": false,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "project"
      },
      "sdk__project_status_path_gid": {
        "description": "The project status update to get.",
        "example": "321654",
        "in": "path",
        "name": "project_status_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "project_status"
      },
      "sdk__project_template_path_gid": {
        "description": "Globally unique identifier for the project template.",
        "example": "1331",
        "in": "path",
        "name": "project_template_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "project_template"
      },
      "sdk__rate_path_gid": {
        "description": "Globally unique identifier for the rate.",
        "example": "12345",
        "in": "path",
        "name": "rate_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "rate"
      },
      "sdk__record_path_gid": {
        "description": "Globally unique identifier for the record.",
        "example": "7331",
        "in": "path",
        "name": "record_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "record"
      },
      "sdk__release_path_gid": {
        "description": "Globally unique identifier for the Command release.",
        "example": "987654",
        "in": "path",
        "name": "release_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "release"
      },
      "sdk__role_path_gid": {
        "description": "Globally unique identifier for the role.",
        "example": "12345",
        "in": "path",
        "name": "role_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "role"
      },
      "sdk__rule_trigger_path_gid": {
        "description": "The ID of the incoming web request trigger. This value is a path parameter that is automatically generated for the API endpoint.",
        "example": "12345",
        "in": "path",
        "name": "rule_trigger_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "rule"
      },
      "sdk__search_limit": {
        "description": "Results per search response.\nThe number of objects to return in one search response. The value must be between 1 and 100. Search responses have no `next_page`, so to retrieve further results, sort by `created_at` and repeat the query with a `created_at.before` or `created_at.after` filter that excludes the results you have already seen.",
        "example": 50,
        "in": "query",
        "name": "limit",
        "schema": {
          "maximum": 100,
          "minimum": 1,
          "type": "integer"
        }
      },
      "sdk__section_path_gid": {
        "description": "The globally unique identifier for the section.",
        "example": "321654",
        "in": "path",
        "name": "section_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "section"
      },
      "sdk__status_update_path_gid": {
        "description": "Globally unique identifier for the status update.",
        "example": "321654",
        "in": "path",
        "name": "status_update_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "status"
      },
      "sdk__story_created_after": {
        "description": "Only return stories created after this time. Applies to every story type; pair it with `resource_subtype=comment_added` to get just the comments added since a given moment.\nThe bound is exclusive but has second granularity: it is truncated to the start of its second before filtering, so any story created within that same second is still returned. A client polling with the `created_at` of the last story it saw should expect to see that story again, and others alongside it, and should de-duplicate on `gid`.\n",
        "example": "2012-02-22T02:06:58.158Z",
        "in": "query",
        "name": "created_after",
        "required": false,
        "schema": {
          "format": "date-time",
          "type": "string"
        }
      },
      "sdk__story_path_gid": {
        "description": "Globally unique identifier for the story.",
        "example": "35678",
        "in": "path",
        "name": "story_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "story"
      },
      "sdk__story_resource_subtype": {
        "description": "Only return stories of this subtype. Only `comment_added` is supported, which narrows the response to comments and excludes activity such as assignments, due date changes, and project moves. Omit to return the full activity feed.\n",
        "example": "comment_added",
        "in": "query",
        "name": "resource_subtype",
        "required": false,
        "schema": {
          "enum": [
            "comment_added"
          ],
          "type": "string"
        }
      },
      "sdk__story_sort_ascending": {
        "description": "Creation-time order: `true` (the default) is oldest first, `false` is newest first. Pair `false` with `limit` to read only the most recent stories. Ordering is applied across the parent's stories; on a parent with an extremely large activity feed the feed may be truncated before it is ordered, so pair `false` with `created_after` to bound what is considered.\n",
        "example": false,
        "in": "query",
        "name": "sort_ascending",
        "required": false,
        "schema": {
          "default": true,
          "type": "boolean"
        }
      },
      "sdk__table_path_gid": {
        "description": "Globally unique identifier for the table.",
        "example": "1337",
        "in": "path",
        "name": "table_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "table"
      },
      "sdk__tag_path_gid": {
        "description": "Globally unique identifier for the tag.",
        "example": "11235",
        "in": "path",
        "name": "tag_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "tag"
      },
      "sdk__target_query_param": {
        "description": "Globally unique identifier for the target object.",
        "example": "1331",
        "in": "query",
        "name": "target",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "target"
      },
      "sdk__task_path_gid": {
        "description": "The task to operate on.",
        "example": "321654",
        "in": "path",
        "name": "task_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "task"
      },
      "sdk__task_template_path_gid": {
        "description": "Globally unique identifier for the task template.",
        "example": "1331",
        "in": "path",
        "name": "task_template_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "task_template"
      },
      "sdk__team_membership_path_gid": {
        "example": "724362",
        "in": "path",
        "name": "team_membership_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "team_membership"
      },
      "sdk__team_path_gid": {
        "description": "Globally unique identifier for the team.",
        "example": "159874",
        "in": "path",
        "name": "team_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "team"
      },
      "sdk__team_query_param": {
        "description": "The team to filter projects on.",
        "example": "14916",
        "in": "query",
        "name": "team",
        "schema": {
          "type": "string"
        },
        "x-env-variable": "team"
      },
      "sdk__teamspace_path_gid": {
        "description": "Globally unique identifier for the Command teamspace.",
        "example": "67890",
        "in": "path",
        "name": "teamspace_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "teamspace"
      },
      "sdk__ticket_path_gid": {
        "description": "Globally unique identifier for the Command ticket.",
        "example": "321654",
        "in": "path",
        "name": "ticket_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "ticket"
      },
      "sdk__time_period_path_gid": {
        "description": "Globally unique identifier for the time period.",
        "example": "917392",
        "in": "path",
        "name": "time_period_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "time_period"
      },
      "sdk__time_tracking_category_path_gid": {
        "description": "Globally unique identifier for the time tracking category.",
        "example": "917392",
        "in": "path",
        "name": "time_tracking_category_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "time_tracking_category"
      },
      "sdk__time_tracking_entry_path_gid": {
        "description": "Globally unique identifier for the time tracking entry.",
        "example": "917392",
        "in": "path",
        "name": "time_tracking_entry_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "time_tracking_entry"
      },
      "sdk__timesheet_approval_status_path_gid": {
        "description": "Globally unique identifier for the timesheet approval status.",
        "example": "917392",
        "in": "path",
        "name": "timesheet_approval_status_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "timesheet_approval_status"
      },
      "sdk__todo_path_gid": {
        "description": "Globally unique identifier for the Command to-do.",
        "example": "321654",
        "in": "path",
        "name": "todo_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "todo"
      },
      "sdk__user_path_gid": {
        "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
        "example": "me",
        "in": "path",
        "name": "user_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "user"
      },
      "sdk__user_query_param": {
        "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
        "example": "me",
        "in": "query",
        "name": "user",
        "schema": {
          "type": "string"
        },
        "x-env-variable": "user"
      },
      "sdk__user_task_list_path_gid": {
        "description": "Globally unique identifier for the user task list.",
        "example": "12345",
        "in": "path",
        "name": "user_task_list_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "user_task_list"
      },
      "sdk__webhook_path_gid": {
        "description": "Globally unique identifier for the webhook.",
        "example": "12345",
        "in": "path",
        "name": "webhook_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "webhook"
      },
      "sdk__workspace_membership_path_gid": {
        "example": "12345",
        "in": "path",
        "name": "workspace_membership_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "workspace_membership"
      },
      "sdk__workspace_path_gid": {
        "description": "Globally unique identifier for the workspace or organization.",
        "example": "12345",
        "in": "path",
        "name": "workspace_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "workspace"
      },
      "sdk__workspace_query_param": {
        "description": "The workspace to filter results on.",
        "example": "12345",
        "in": "query",
        "name": "workspace",
        "schema": {
          "type": "string"
        },
        "x-env-variable": "workspace"
      },
      "search_limit": {
        "description": "Results per search response.\nThe number of objects to return in one search response. The value must be between 1 and 100. Search responses have no `next_page`, so to retrieve further results, sort by `created_at` and repeat the query with a `created_at.before` or `created_at.after` filter that excludes the results you have already seen.",
        "example": 50,
        "in": "query",
        "name": "limit",
        "schema": {
          "maximum": 100,
          "minimum": 1,
          "type": "integer"
        }
      },
      "section_path_gid": {
        "description": "The globally unique identifier for the section.",
        "example": "321654",
        "in": "path",
        "name": "section_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "section"
      },
      "status_update_path_gid": {
        "description": "Globally unique identifier for the status update.",
        "example": "321654",
        "in": "path",
        "name": "status_update_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "status"
      },
      "story_created_after": {
        "description": "Only return stories created after this time. Applies to every story type; pair it with `resource_subtype=comment_added` to get just the comments added since a given moment.\nThe bound is exclusive but has second granularity: it is truncated to the start of its second before filtering, so any story created within that same second is still returned. A client polling with the `created_at` of the last story it saw should expect to see that story again, and others alongside it, and should de-duplicate on `gid`.\n",
        "example": "2012-02-22T02:06:58.158Z",
        "in": "query",
        "name": "created_after",
        "required": false,
        "schema": {
          "format": "date-time",
          "type": "string"
        }
      },
      "story_path_gid": {
        "description": "Globally unique identifier for the story.",
        "example": "35678",
        "in": "path",
        "name": "story_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "story"
      },
      "story_resource_subtype": {
        "description": "Only return stories of this subtype. Only `comment_added` is supported, which narrows the response to comments and excludes activity such as assignments, due date changes, and project moves. Omit to return the full activity feed.\n",
        "example": "comment_added",
        "in": "query",
        "name": "resource_subtype",
        "required": false,
        "schema": {
          "enum": [
            "comment_added"
          ],
          "type": "string"
        }
      },
      "story_sort_ascending": {
        "description": "Creation-time order: `true` (the default) is oldest first, `false` is newest first. Pair `false` with `limit` to read only the most recent stories. Ordering is applied across the parent's stories; on a parent with an extremely large activity feed the feed may be truncated before it is ordered, so pair `false` with `created_after` to bound what is considered.\n",
        "example": false,
        "in": "query",
        "name": "sort_ascending",
        "required": false,
        "schema": {
          "default": true,
          "type": "boolean"
        }
      },
      "table_path_gid": {
        "description": "Globally unique identifier for the table.",
        "example": "1337",
        "in": "path",
        "name": "table_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "table"
      },
      "tag_path_gid": {
        "description": "Globally unique identifier for the tag.",
        "example": "11235",
        "in": "path",
        "name": "tag_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "tag"
      },
      "target_query_param": {
        "description": "Globally unique identifier for the target object.",
        "example": "1331",
        "in": "query",
        "name": "target",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "target"
      },
      "task_path_gid": {
        "description": "The task to operate on.",
        "example": "321654",
        "in": "path",
        "name": "task_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "task"
      },
      "task_template_path_gid": {
        "description": "Globally unique identifier for the task template.",
        "example": "1331",
        "in": "path",
        "name": "task_template_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "task_template"
      },
      "team_membership_path_gid": {
        "example": "724362",
        "in": "path",
        "name": "team_membership_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "team_membership"
      },
      "team_path_gid": {
        "description": "Globally unique identifier for the team.",
        "example": "159874",
        "in": "path",
        "name": "team_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "team"
      },
      "team_query_param": {
        "description": "The team to filter projects on.",
        "example": "14916",
        "in": "query",
        "name": "team",
        "schema": {
          "type": "string"
        },
        "x-env-variable": "team"
      },
      "teamspace_path_gid": {
        "description": "Globally unique identifier for the Command teamspace.",
        "example": "67890",
        "in": "path",
        "name": "teamspace_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "teamspace"
      },
      "ticket_path_gid": {
        "description": "Globally unique identifier for the Command ticket.",
        "example": "321654",
        "in": "path",
        "name": "ticket_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "ticket"
      },
      "time_period_path_gid": {
        "description": "Globally unique identifier for the time period.",
        "example": "917392",
        "in": "path",
        "name": "time_period_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "time_period"
      },
      "time_tracking_category_path_gid": {
        "description": "Globally unique identifier for the time tracking category.",
        "example": "917392",
        "in": "path",
        "name": "time_tracking_category_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "time_tracking_category"
      },
      "time_tracking_entry_path_gid": {
        "description": "Globally unique identifier for the time tracking entry.",
        "example": "917392",
        "in": "path",
        "name": "time_tracking_entry_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "time_tracking_entry"
      },
      "timesheet_approval_status_path_gid": {
        "description": "Globally unique identifier for the timesheet approval status.",
        "example": "917392",
        "in": "path",
        "name": "timesheet_approval_status_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "timesheet_approval_status"
      },
      "todo_path_gid": {
        "description": "Globally unique identifier for the Command to-do.",
        "example": "321654",
        "in": "path",
        "name": "todo_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "todo"
      },
      "user_path_gid": {
        "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
        "example": "me",
        "in": "path",
        "name": "user_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "user"
      },
      "user_query_param": {
        "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
        "example": "me",
        "in": "query",
        "name": "user",
        "schema": {
          "type": "string"
        },
        "x-env-variable": "user"
      },
      "user_task_list_path_gid": {
        "description": "Globally unique identifier for the user task list.",
        "example": "12345",
        "in": "path",
        "name": "user_task_list_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "user_task_list"
      },
      "webhook_path_gid": {
        "description": "Globally unique identifier for the webhook.",
        "example": "12345",
        "in": "path",
        "name": "webhook_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "webhook"
      },
      "workspace_membership_path_gid": {
        "example": "12345",
        "in": "path",
        "name": "workspace_membership_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "workspace_membership"
      },
      "workspace_path_gid": {
        "description": "Globally unique identifier for the workspace or organization.",
        "example": "12345",
        "in": "path",
        "name": "workspace_gid",
        "required": true,
        "schema": {
          "type": "string"
        },
        "x-env-variable": "workspace"
      },
      "workspace_query_param": {
        "description": "The workspace to filter results on.",
        "example": "12345",
        "in": "query",
        "name": "workspace",
        "schema": {
          "type": "string"
        },
        "x-env-variable": "workspace"
      }
    },
    "responses": {
      "BadGateway": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "description": "There is an issue between the load balancers and Asana's API."
      },
      "BadRequest": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "description": "This usually occurs because of a missing or malformed parameter. Check the documentation and the syntax of your request and try again."
      },
      "Conflict": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "description": "The request could not be completed because it conflicts with the current state of the target resource."
      },
      "Forbidden": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "description": "The authentication and request syntax was valid but the server is refusing to complete the request. This can happen if you try to read or write to objects or properties that the user does not have access to."
      },
      "GatewayTimeout": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "description": "This request took too long to complete."
      },
      "GenericErrorResponse": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "description": "Sadly, sometimes requests to the API are not successful. Failures can occur for a wide range of reasons. In all cases, the API should return an HTTP Status Code that indicates the nature of the failure, with a response body in JSON format containing additional information. In the event of a server error the response body will contain an error phrase. These phrases are automatically generated using the [node-asana-phrase library](https://github.com/Asana/node-asana-phrase) and can be used by Asana support to quickly look up the incident that caused the server error."
      },
      "InternalServerError": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "description": "There was a problem on Asana’s end. In the event of a server error the response body should contain an error phrase. These phrases can be used by Asana support to quickly look up the incident that caused the server error. Some errors are due to server load, and will not supply an error phrase."
      },
      "NotFound": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "description": "Either the request method and path supplied do not specify a known action in the API, or the object specified by the request does not exist."
      },
      "PaymentRequired": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "description": "The request was valid, but the queried object or object mutation specified in the request is above your current premium level."
      },
      "ServiceUnavailable": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "description": "Either the upstream service is unavailable to the API, or the API has been intentionally shut off."
      },
      "TooManyRequests": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "description": "You have exceeded one of the enforced rate limits in the API. See the [documentation on rate limiting](https://developers.asana.com/docs/#rate-limits) for more information."
      },
      "Unauthorized": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "description": "A valid authentication token was not provided with the request, so the API could not associate a user with the request."
      },
      "sdk__AccessRequestResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__AccessRequestResponseArray"
            }
          }
        }
      },
      "sdk__AccessRequestResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__AccessRequestResponseData"
            }
          }
        }
      },
      "sdk__AgentResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__AgentResponseArray"
            }
          }
        }
      },
      "sdk__AgentResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__AgentResponseData"
            }
          }
        }
      },
      "sdk__AiStudioRunResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__AiStudioRunResponseArray"
            }
          }
        }
      },
      "sdk__AiStudioSeatResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__AiStudioSeatResponseArray"
            }
          }
        }
      },
      "sdk__AllocationResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__AllocationResponseArray"
            }
          }
        }
      },
      "sdk__AllocationResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__AllocationResponseData"
            }
          }
        }
      },
      "sdk__AsanaNamedResourceArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__AsanaNamedResourceArray"
            }
          }
        }
      },
      "sdk__AttachmentResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__AttachmentResponseArray"
            }
          }
        }
      },
      "sdk__AttachmentResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__AttachmentResponseData"
            }
          }
        }
      },
      "sdk__AuditLogEventArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__AuditLogEventArray"
            }
          }
        }
      },
      "sdk__BadGateway": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ErrorResponse"
            }
          }
        },
        "description": "There is an issue between the load balancers and Asana's API."
      },
      "sdk__BadRequest": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ErrorResponse"
            }
          }
        },
        "description": "This usually occurs because of a missing or malformed parameter. Check the documentation and the syntax of your request and try again."
      },
      "sdk__BatchResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__BatchResponseArray"
            }
          }
        }
      },
      "sdk__BudgetResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__BudgetResponseArray"
            }
          }
        }
      },
      "sdk__BudgetResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__BudgetResponseData"
            }
          }
        }
      },
      "sdk__Conflict": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ErrorResponse"
            }
          }
        },
        "description": "The request could not be completed because it conflicts with the current state of the target resource."
      },
      "sdk__CustomFieldResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__CustomFieldResponseArray"
            }
          }
        }
      },
      "sdk__CustomFieldResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__CustomFieldResponseData"
            }
          }
        }
      },
      "sdk__CustomFieldSettingResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__CustomFieldSettingResponseArray"
            }
          }
        }
      },
      "sdk__CustomFieldSettingResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__CustomFieldSettingResponseData"
            }
          }
        }
      },
      "sdk__CustomFieldTableSettingResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__CustomFieldTableSettingResponseArray"
            }
          }
        }
      },
      "sdk__CustomFieldTableSettingResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__CustomFieldTableSettingResponseData"
            }
          }
        }
      },
      "sdk__CustomTypeResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__CustomTypeResponseArray"
            }
          }
        }
      },
      "sdk__CustomTypeResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__CustomTypeResponseData"
            }
          }
        }
      },
      "sdk__DeprecatedPortfolioMembershipResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__DeprecatedPortfolioMembershipResponseArray"
            }
          }
        }
      },
      "sdk__DeprecatedPortfolioMembershipResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__DeprecatedPortfolioMembershipResponseData"
            }
          }
        }
      },
      "sdk__EmptyResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__EmptyResponseData"
            }
          }
        }
      },
      "sdk__EnumOptionData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__EnumOptionData"
            }
          }
        }
      },
      "sdk__EventResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__EventResponseArray"
            }
          }
        }
      },
      "sdk__Forbidden": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ErrorResponse"
            }
          }
        },
        "description": "The authentication and request syntax was valid but the server is refusing to complete the request. This can happen if you try to read or write to objects or properties that the user does not have access to."
      },
      "sdk__GatewayTimeout": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ErrorResponse"
            }
          }
        },
        "description": "This request took too long to complete."
      },
      "sdk__GenericErrorResponse": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ErrorResponse"
            }
          }
        },
        "description": "Sadly, sometimes requests to the API are not successful. Failures can occur for a wide range of reasons. In all cases, the API should return an HTTP Status Code that indicates the nature of the failure, with a response body in JSON format containing additional information. In the event of a server error the response body will contain an error phrase. These phrases are automatically generated using the [node-asana-phrase library](https://github.com/Asana/node-asana-phrase) and can be used by Asana support to quickly look up the incident that caused the server error."
      },
      "sdk__GoalRelationshipResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__GoalRelationshipResponseArray"
            }
          }
        }
      },
      "sdk__GoalRelationshipResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__GoalRelationshipResponseData"
            }
          }
        }
      },
      "sdk__GoalResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__GoalResponseArray"
            }
          }
        }
      },
      "sdk__GoalResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__GoalResponseData"
            }
          }
        }
      },
      "sdk__GraphExportResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__GraphExportResponseData"
            }
          }
        }
      },
      "sdk__InternalServerError": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ErrorResponse"
            }
          }
        },
        "description": "There was a problem on Asana’s end. In the event of a server error the response body should contain an error phrase. These phrases can be used by Asana support to quickly look up the incident that caused the server error. Some errors are due to server load, and will not supply an error phrase."
      },
      "sdk__JobResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__JobResponseData"
            }
          }
        }
      },
      "sdk__MarkNotificationsResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__MarkNotificationsResponseData"
            }
          }
        }
      },
      "sdk__MembershipResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__MembershipResponseArray"
            }
          }
        }
      },
      "sdk__MembershipResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__MembershipResponseData"
            }
          }
        }
      },
      "sdk__NotFound": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ErrorResponse"
            }
          }
        },
        "description": "Either the request method and path supplied do not specify a known action in the API, or the object specified by the request does not exist."
      },
      "sdk__NotificationResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__NotificationResponseArray"
            }
          }
        }
      },
      "sdk__OooEntryResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__OooEntryResponseArray"
            }
          }
        }
      },
      "sdk__OooEntryResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__OooEntryResponseData"
            }
          }
        }
      },
      "sdk__OrganizationExportResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__OrganizationExportResponseData"
            }
          }
        }
      },
      "sdk__PaymentRequired": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ErrorResponse"
            }
          }
        },
        "description": "The request was valid, but the queried object or object mutation specified in the request is above your current premium level."
      },
      "sdk__PortfolioItemCompactArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__PortfolioItemCompactArray"
            }
          }
        }
      },
      "sdk__PortfolioResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__PortfolioResponseArray"
            }
          }
        }
      },
      "sdk__PortfolioResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__PortfolioResponseData"
            }
          }
        }
      },
      "sdk__ProjectBriefResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ProjectBriefResponseData"
            }
          }
        }
      },
      "sdk__ProjectMembershipCompactArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ProjectMembershipCompactArray"
            }
          }
        }
      },
      "sdk__ProjectMembershipNormalResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ProjectMembershipNormalResponseData"
            }
          }
        }
      },
      "sdk__ProjectPortfolioSettingResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ProjectPortfolioSettingResponseArray"
            }
          }
        }
      },
      "sdk__ProjectPortfolioSettingResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ProjectPortfolioSettingResponseData"
            }
          }
        }
      },
      "sdk__ProjectResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ProjectResponseArray"
            }
          }
        }
      },
      "sdk__ProjectResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ProjectResponseData"
            }
          }
        }
      },
      "sdk__ProjectStatusResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ProjectStatusResponseArray"
            }
          }
        }
      },
      "sdk__ProjectStatusResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ProjectStatusResponseData"
            }
          }
        }
      },
      "sdk__ProjectTemplateResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ProjectTemplateResponseArray"
            }
          }
        }
      },
      "sdk__ProjectTemplateResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ProjectTemplateResponseData"
            }
          }
        }
      },
      "sdk__RateOrPlaceholderCompactArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__RateOrPlaceholderCompactArray"
            }
          }
        }
      },
      "sdk__RateResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__RateResponseData"
            }
          }
        }
      },
      "sdk__RbacRoleResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__RbacRoleResponseArray"
            }
          }
        }
      },
      "sdk__RbacRoleResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__RbacRoleResponseData"
            }
          }
        }
      },
      "sdk__ReactionCompactArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ReactionCompactArray"
            }
          }
        }
      },
      "sdk__RecordItemResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__RecordItemResponseArray"
            }
          }
        }
      },
      "sdk__RecordItemResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__RecordItemResponseData"
            }
          }
        }
      },
      "sdk__ResourceExportResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ResourceExportResponseData"
            }
          }
        }
      },
      "sdk__RuleTriggerResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__RuleTriggerResponseData"
            }
          }
        }
      },
      "sdk__SectionResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__SectionResponseArray"
            }
          }
        }
      },
      "sdk__SectionResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__SectionResponseData"
            }
          }
        }
      },
      "sdk__ServiceUnavailable": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ErrorResponse"
            }
          }
        },
        "description": "Either the upstream service is unavailable to the API, or the API has been intentionally shut off."
      },
      "sdk__StatusUpdateResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__StatusUpdateResponseArray"
            }
          }
        }
      },
      "sdk__StatusUpdateResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__StatusUpdateResponseData"
            }
          }
        }
      },
      "sdk__StoryResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__StoryResponseArray"
            }
          }
        }
      },
      "sdk__StoryResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__StoryResponseData"
            }
          }
        }
      },
      "sdk__TableResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__TableResponseArray"
            }
          }
        }
      },
      "sdk__TableResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__TableResponseData"
            }
          }
        }
      },
      "sdk__TagResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__TagResponseArray"
            }
          }
        }
      },
      "sdk__TagResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__TagResponseData"
            }
          }
        }
      },
      "sdk__TaskCountResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__TaskCountResponseData"
            }
          }
        }
      },
      "sdk__TaskResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__TaskResponseArray"
            }
          }
        }
      },
      "sdk__TaskResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__TaskResponseData"
            }
          }
        }
      },
      "sdk__TaskTemplateResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__TaskTemplateResponseArray"
            }
          }
        }
      },
      "sdk__TaskTemplateResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__TaskTemplateResponseData"
            }
          }
        }
      },
      "sdk__TeamMembershipResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__TeamMembershipResponseArray"
            }
          }
        }
      },
      "sdk__TeamMembershipResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__TeamMembershipResponseData"
            }
          }
        }
      },
      "sdk__TeamResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__TeamResponseArray"
            }
          }
        }
      },
      "sdk__TeamResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__TeamResponseData"
            }
          }
        }
      },
      "sdk__TimePeriodResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__TimePeriodResponseArray"
            }
          }
        }
      },
      "sdk__TimePeriodResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__TimePeriodResponseData"
            }
          }
        }
      },
      "sdk__TimeTrackingCategoryResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__TimeTrackingCategoryResponseArray"
            }
          }
        }
      },
      "sdk__TimeTrackingCategoryResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__TimeTrackingCategoryResponseData"
            }
          }
        }
      },
      "sdk__TimeTrackingEntryBaseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__TimeTrackingEntryBaseData"
            }
          }
        }
      },
      "sdk__TimeTrackingEntryCompactArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__TimeTrackingEntryCompactArray"
            }
          }
        }
      },
      "sdk__TimesheetApprovalStatusResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__TimesheetApprovalStatusResponseArray"
            }
          }
        }
      },
      "sdk__TimesheetApprovalStatusResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__TimesheetApprovalStatusResponseData"
            }
          }
        }
      },
      "sdk__TooManyRequests": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ErrorResponse"
            }
          }
        },
        "description": "You have exceeded one of the enforced rate limits in the API. See the [documentation on rate limiting](https://developers.asana.com/docs/#rate-limits) for more information."
      },
      "sdk__Unauthorized": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__ErrorResponse"
            }
          }
        },
        "description": "A valid authentication token was not provided with the request, so the API could not associate a user with the request."
      },
      "sdk__UserBaseResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__UserBaseResponseData"
            }
          }
        }
      },
      "sdk__UserResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__UserResponseArray"
            }
          }
        }
      },
      "sdk__UserResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__UserResponseData"
            }
          }
        }
      },
      "sdk__UserTaskListResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__UserTaskListResponseData"
            }
          }
        }
      },
      "sdk__WebhookResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__WebhookResponseArray"
            }
          }
        }
      },
      "sdk__WebhookResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__WebhookResponseData"
            }
          }
        }
      },
      "sdk__WorkspaceMembershipResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__WorkspaceMembershipResponseArray"
            }
          }
        }
      },
      "sdk__WorkspaceMembershipResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__WorkspaceMembershipResponseData"
            }
          }
        }
      },
      "sdk__WorkspaceResponseArray": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__WorkspaceResponseArray"
            }
          }
        }
      },
      "sdk__WorkspaceResponseData": {
        "content": {
          "application/json; charset=UTF-8": {
            "schema": {
              "$ref": "#/components/schemas/sdk__WorkspaceResponseData"
            }
          }
        }
      }
    },
    "schemas": {
      "AccessRequestApproveRequest": {
        "description": "A request to approve access for a user.",
        "properties": {
          "access_request_gid": {
            "description": "The ID of the access request that the user is approving.",
            "example": "12345",
            "type": "string"
          }
        },
        "type": "object"
      },
      "AccessRequestCreateRequest": {
        "description": "A request to create shareable access for a user.",
        "properties": {
          "message": {
            "description": "The optional message to include with the access request. This can be used to provide context or additional information about the request.",
            "example": "I'm looking to request access to this item.",
            "nullable": true,
            "type": "string"
          },
          "target": {
            "description": "The access requestable object that the user is requesting access to. This is the gid of the target. Supports projects and portfolios.",
            "example": "12345",
            "type": "string"
          }
        },
        "required": [
          "target"
        ],
        "type": "object"
      },
      "AccessRequestRejectRequest": {
        "description": "A request to reject access for a user.",
        "properties": {
          "access_request_gid": {
            "description": "The ID of the access request that the user is rejecting.",
            "example": "12345",
            "type": "string"
          }
        },
        "type": "object"
      },
      "AccessRequestResponse": {
        "description": "A *access request* object represents a request to access a shareable resource within Asana. It includes the requester's information, approval status, and target resource details.",
        "properties": {
          "approval_status": {
            "description": "The current approval status of the request.",
            "enum": [
              "pending",
              "approved",
              "denied"
            ],
            "example": "pending",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "message": {
            "description": "The message included in the access request, if any.",
            "example": "Please grant me access to this resource.",
            "type": "string"
          },
          "requester": {
            "$ref": "#/components/schemas/UserCompact",
            "description": "The user who made the access request.",
            "readOnly": true
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "access_request",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "target": {
            "$ref": "#/components/schemas/AccessRequestTargetIdCompact",
            "description": "The target resource that the requester wants access to.",
            "readOnly": true
          }
        },
        "type": "object"
      },
      "AccessRequestTargetIdCompact": {
        "description": "A *target id* object represents the target resource that the requester wants access to.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "project",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "AddCustomFieldSettingRequest": {
        "properties": {
          "custom_field": {
            "oneOf": [
              {
                "description": "The custom field to associate with this container.",
                "example": "14916",
                "type": "string"
              },
              {
                "$ref": "#/components/schemas/CustomFieldCreateRequest"
              }
            ]
          },
          "insert_after": {
            "description": "A gid of a Custom Field Setting on this container, after which the new Custom Field Setting will be added.  `insert_before` and `insert_after` parameters cannot both be specified.",
            "example": "1331",
            "type": "string"
          },
          "insert_before": {
            "description": "A gid of a Custom Field Setting on this container, before which the new Custom Field Setting will be added.  `insert_before` and `insert_after` parameters cannot both be specified.",
            "example": "1331",
            "type": "string"
          },
          "is_important": {
            "description": "Whether this field should be considered important to this container (for instance, to display in the list view of items in the container).",
            "example": true,
            "type": "boolean"
          }
        },
        "required": [
          "custom_field"
        ],
        "type": "object"
      },
      "AddFollowersRequest": {
        "properties": {
          "followers": {
            "description": "An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user.",
            "example": "521621,621373",
            "type": "string"
          }
        },
        "required": [
          "followers"
        ],
        "type": "object"
      },
      "AddMembersRequest": {
        "properties": {
          "members": {
            "description": "An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user.",
            "example": "521621,621373",
            "type": "string"
          }
        },
        "required": [
          "members"
        ],
        "type": "object"
      },
      "AgentCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The display name of the agent.",
            "example": "Developer Blog Writer",
            "readOnly": true,
            "type": "string"
          },
          "resource_subtype": {
            "description": "The subtype of the agent. `asana_teammate` is an Asana-built teammate.",
            "enum": [
              "asana_teammate"
            ],
            "example": "asana_teammate",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "agent",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "AgentResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/AgentCompact"
          },
          {
            "properties": {
              "behavior_guidance": {
                "description": "A description of the agent's behavior.",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "description": {
                "description": "A brief description of what the agent does.",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "photo": {
                "description": "A map of the agent's avatar image in various sizes, or null if no photo is set.",
                "example": {
                  "image_1024x1024": "https://...",
                  "image_128x128": "https://...",
                  "image_21x21": "https://...",
                  "image_27x27": "https://...",
                  "image_36x36": "https://...",
                  "image_60x60": "https://..."
                },
                "nullable": true,
                "properties": {
                  "image_1024x1024": {
                    "description": "JPEG image at 1024x1024 pixels.",
                    "format": "uri",
                    "type": "string"
                  },
                  "image_128x128": {
                    "description": "PNG image at 128x128 pixels.",
                    "format": "uri",
                    "type": "string"
                  },
                  "image_21x21": {
                    "description": "PNG image at 21x21 pixels.",
                    "format": "uri",
                    "type": "string"
                  },
                  "image_27x27": {
                    "description": "PNG image at 27x27 pixels.",
                    "format": "uri",
                    "type": "string"
                  },
                  "image_36x36": {
                    "description": "PNG image at 36x36 pixels.",
                    "format": "uri",
                    "type": "string"
                  },
                  "image_60x60": {
                    "description": "PNG image at 60x60 pixels.",
                    "format": "uri",
                    "type": "string"
                  }
                },
                "readOnly": true,
                "type": "object"
              },
              "workspace": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/WorkspaceCompact"
                  },
                  {
                    "type": "object"
                  }
                ],
                "description": "The workspace this agent is instantiated within.",
                "readOnly": true
              }
            },
            "required": [
              "workspace"
            ],
            "type": "object"
          }
        ]
      },
      "AiStudioRunCompact": {
        "description": "A single AI Studio run (rule execution), representing the credits consumed by one execution of an AI Studio rule.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "ai_studio_run",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "AiStudioRunResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/AiStudioRunCompact"
          },
          {
            "description": "A single AI Studio run (rule execution). The `gid` is stable and serves as the de-duplication key for incremental loads.",
            "properties": {
              "automation": {
                "description": "The multi-step automation (AutomationWorkflow) the step belonged to when it ran. `null` for standalone rules. Non-null for workflow steps regardless of whether the step itself was later deleted. Each step of a multi-step automation run is returned as its own row with the same `automation`, so group by `automation.gid` to reconstruct per-automation usage. Not dereferenceable yet (no public Automations API).",
                "nullable": true,
                "properties": {
                  "gid": {
                    "example": "1208222222222222",
                    "readOnly": true,
                    "type": "string"
                  },
                  "name": {
                    "example": "Intake triage automation",
                    "readOnly": true,
                    "type": "string"
                  },
                  "resource_type": {
                    "example": "automation",
                    "readOnly": true,
                    "type": "string"
                  }
                },
                "readOnly": true,
                "type": "object"
              },
              "credit_source": {
                "description": "Whether the credits were drawn from a paid or free balance.",
                "enum": [
                  "paid",
                  "free"
                ],
                "readOnly": true,
                "type": "string"
              },
              "credits_used": {
                "description": "The number of credits consumed by the run.",
                "example": 12,
                "readOnly": true,
                "type": "number"
              },
              "division": {
                "description": "The division the actor belonged to at the time of the run, as a compact reference. `null` when division metering is not enabled for the domain. Not dereferenceable yet (no public Division API); `name` reflects the division's current state.",
                "nullable": true,
                "properties": {
                  "gid": {
                    "example": "1205000000000003",
                    "readOnly": true,
                    "type": "string"
                  },
                  "name": {
                    "example": "Engineering",
                    "readOnly": true,
                    "type": "string"
                  },
                  "resource_type": {
                    "example": "division",
                    "readOnly": true,
                    "type": "string"
                  }
                },
                "readOnly": true,
                "type": "object"
              },
              "model": {
                "description": "The LLM model used for the run.",
                "example": "claude-sonnet-4-6",
                "readOnly": true,
                "type": "string"
              },
              "rule": {
                "description": "The rule (AutomationStep) that ran, as a compact reference. Non-null for both standalone rules and multi-step automation steps as long as the step still exists. `null` if the step was deleted after the run. The Rules API is not yet public, so this is not dereferenceable today, but the shape is forward-compatible (consumers can key off `rule.gid`).",
                "nullable": true,
                "properties": {
                  "gid": {
                    "example": "1208111111111111",
                    "readOnly": true,
                    "type": "string"
                  },
                  "name": {
                    "example": "Auto-summarize incoming requests",
                    "readOnly": true,
                    "type": "string"
                  },
                  "resource_type": {
                    "example": "rule",
                    "readOnly": true,
                    "type": "string"
                  }
                },
                "readOnly": true,
                "type": "object"
              },
              "rule_owner": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/UserCompact"
                  },
                  {
                    "description": "The user who owns the rule.",
                    "properties": {
                      "email": {
                        "example": "owner@example.com",
                        "readOnly": true,
                        "type": "string"
                      }
                    },
                    "readOnly": true,
                    "type": "object"
                  }
                ]
              },
              "run_completed_at": {
                "description": "When the run finished. `null` for runs that did not complete (e.g. cancelled). Runs still in progress don't appear in this endpoint (a usage record exists only once a run is metered), so this is non-null for every success/failed run.",
                "example": "2026-05-01T14:03:15.220Z",
                "format": "date-time",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "run_started_at": {
                "description": "When the run was triggered.",
                "example": "2026-05-01T14:03:12.000Z",
                "format": "date-time",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "status": {
                "description": "The outcome of the run.",
                "enum": [
                  "success",
                  "failed",
                  "cancelled"
                ],
                "readOnly": true,
                "type": "string"
              },
              "triggered_by": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/UserCompact"
                  },
                  {
                    "description": "The user the run executed as, and to whom the credits are attributed. Usually the same as `rule_owner`, but can differ for chained or AI-teammate-triggered runs.",
                    "properties": {
                      "email": {
                        "example": "runner@example.com",
                        "readOnly": true,
                        "type": "string"
                      }
                    },
                    "readOnly": true,
                    "type": "object"
                  }
                ]
              },
              "triggering_container": {
                "description": "The object the rule lives in (its container) — a project or portfolio — as a compact reference. `null` if the container is unavailable.",
                "nullable": true,
                "properties": {
                  "gid": {
                    "example": "1206000000000001",
                    "readOnly": true,
                    "type": "string"
                  },
                  "resource_type": {
                    "enum": [
                      "project",
                      "portfolio"
                    ],
                    "example": "project",
                    "readOnly": true,
                    "type": "string"
                  }
                },
                "readOnly": true,
                "type": "object"
              }
            },
            "type": "object"
          }
        ]
      },
      "AiStudioSeatCompact": {
        "description": "A single AI Studio seat allocation, representing one user's access to AI Studio in the workspace.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "ai_studio_seat",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "AiStudioSeatResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/AiStudioSeatCompact"
          },
          {
            "description": "A single AI Studio seat allocation (current snapshot).",
            "properties": {
              "assigned_at": {
                "description": "When the seat was granted/assigned.",
                "example": "2026-03-01T00:00:00.000Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "assigned_by": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/UserCompact"
                  },
                  {
                    "description": "The user who assigned the seat. `null` when assigned by the system.",
                    "readOnly": true,
                    "type": "object"
                  }
                ],
                "nullable": true
              },
              "license": {
                "description": "The user's effective AI Studio license tier. `/seats` returns only paid seats, so the free tier is not included.",
                "enum": [
                  "ai_studio_plus",
                  "ai_studio_pro",
                  "ai_studio_max"
                ],
                "readOnly": true,
                "type": "string"
              },
              "revoked_at": {
                "description": "When the seat was revoked or expired. `null` for active seats.",
                "format": "date-time",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "state": {
                "description": "The state of the seat.",
                "enum": [
                  "active",
                  "revoked",
                  "expired"
                ],
                "readOnly": true,
                "type": "string"
              },
              "user": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/UserCompact"
                  },
                  {
                    "description": "The user who holds the seat.",
                    "properties": {
                      "email": {
                        "example": "user@example.com",
                        "readOnly": true,
                        "type": "string"
                      }
                    },
                    "readOnly": true,
                    "type": "object"
                  }
                ]
              }
            },
            "type": "object"
          }
        ]
      },
      "AllocationBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "effort": {
            "description": "The amount of time associated with the allocation, represented as a percentage or number of hours.",
            "nullable": true,
            "properties": {
              "type": {
                "description": "The units used for tracking effort on an allocation, either \"hours\" or \"percent\".",
                "enum": [
                  "hours",
                  "percent"
                ],
                "type": "string"
              },
              "value": {
                "description": "The numeric effort value on the allocation.",
                "example": 50,
                "type": "number"
              }
            },
            "type": "object"
          },
          "end_date": {
            "description": "The localized day on which the allocation ends.",
            "example": "2024-02-28",
            "format": "date",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "allocation",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_date": {
            "description": "The localized day on which the allocation starts.",
            "example": "2024-02-28",
            "format": "date",
            "type": "string"
          }
        },
        "type": "object"
      },
      "AllocationRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/AllocationBase"
          },
          {
            "properties": {
              "assignee": {
                "description": "Globally unique identifier for the user or placeholder assigned to the allocation.",
                "type": "string"
              },
              "parent": {
                "description": "Globally unique identifier for the project the allocation is on.",
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "AllocationResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/AllocationBase"
          },
          {
            "properties": {
              "assignee": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/UserCompact"
                  },
                  {
                    "description": "The user or placeholder assigned to the allocation.",
                    "properties": {
                      "name": {
                        "description": "The name of allocation resource.",
                        "example": "Greg Sanchez",
                        "type": "string"
                      }
                    },
                    "type": "object"
                  }
                ]
              },
              "created_by": {
                "$ref": "#/components/schemas/UserCompact",
                "description": "The user who created the allocation.",
                "type": "object"
              },
              "parent": {
                "$ref": "#/components/schemas/ProjectCompact",
                "description": "The project the allocation is on.",
                "type": "object"
              },
              "resource_subtype": {
                "description": "The subtype of the allocation.",
                "example": "project_allocation",
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "AsanaNamedResource": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the object.",
            "example": "Bug Task",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "AsanaResource": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "AttachmentBase": {
        "$ref": "#/components/schemas/AttachmentCompact"
      },
      "AttachmentCompact": {
        "description": "An *attachment* object represents any file attached to a task in Asana, whether it's an uploaded file or one associated via a third-party service such as Dropbox or Google Drive.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the file.",
            "example": "Screenshot.png",
            "readOnly": true,
            "type": "string"
          },
          "resource_subtype": {
            "description": "The service hosting the attachment. Valid values are `asana`, `dropbox`, `gdrive`, `onedrive`, `box`, `vimeo`, and `external`.",
            "example": "dropbox",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "attachment",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "AttachmentRequest": {
        "properties": {
          "connect_to_app": {
            "description": "*Optional*. Only relevant for external attachments with a parent task.\nA boolean indicating whether the current app should be connected with\nthe attachment for the purposes of showing an app components widget.\nRequires the app to have been added to a project the parent task is in.\nThis property can only be set if an OAuth token is used to authenticate the request.\n\nCriteria for displaying app widget:\n1. An OAuth token must be used to authenticate the request\n2. The app needs to have its `widget_metadata_url` configured in the developer console\n3. The task the attachment is being attached to must be in a project with the app installed",
            "type": "boolean"
          },
          "file": {
            "description": "Required for `asana` attachments.\n",
            "format": "binary",
            "type": "string"
          },
          "name": {
            "description": "The name of the external resource being attached. Required for attachments of type `external`.\n",
            "type": "string"
          },
          "parent": {
            "description": "Required identifier of the parent task, project, or project_brief, as a string.\n",
            "type": "string"
          },
          "resource_subtype": {
            "description": "The type of the attachment. Must be one of the given values. If not specified, a file attachment of type `asana` will be assumed. Note that if the value of `resource_subtype` is `external`, a `parent`, `name`, and `url` must also be provided.\n",
            "enum": [
              "asana",
              "external"
            ],
            "example": "external",
            "type": "string"
          },
          "url": {
            "description": "The URL of the external resource being attached. Required for attachments of type `external`.\n",
            "type": "string"
          }
        },
        "required": [
          "parent"
        ],
        "type": "object"
      },
      "AttachmentResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/AttachmentBase"
          },
          {
            "properties": {
              "connected_to_app": {
                "description": "Whether the attachment is connected to the app making the request for the purposes of showing an app components widget. Only present when the `resource_subtype` is `external` or `gdrive`.",
                "readOnly": true,
                "type": "boolean"
              },
              "created_at": {
                "description": "The time at which this resource was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "download_url": {
                "description": "The URL containing the content of the attachment.\n*Note:* May be null if the attachment is hosted by [Box](https://www.box.com/) and will be null if the attachment is a Video Message hosted by [Vimeo](https://vimeo.com/). If present, this URL may only be valid for two minutes from the time of retrieval. You should avoid persisting this URL somewhere and just refresh it on demand to ensure you do not keep stale URLs.",
                "example": "https://s3.amazonaws.com/assets/1234/Screenshot.png",
                "format": "uri",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "host": {
                "description": "The service hosting the attachment. Valid values are `asana`, `dropbox`, `gdrive`, `onedrive`, `box`, `vimeo`, and `external`.",
                "example": "dropbox",
                "readOnly": true,
                "type": "string"
              },
              "parent": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TaskCompact"
                  },
                  {
                    "description": "The task this attachment is attached to.",
                    "properties": {
                      "resource_subtype": {
                        "description": "The resource subtype of the parent resource that the filter applies to.",
                        "example": "default_task",
                        "nullable": true,
                        "type": "string"
                      }
                    },
                    "readOnly": true,
                    "type": "object"
                  }
                ],
                "nullable": true
              },
              "permanent_url": {
                "description": "A stable URL for accessing the attachment through the Asana web application. This URL redirects to the file download location (e.g., an S3 link) if the user is authenticated and authorized to view the parent object (e.g., a task). Unauthorized users will receive a `403 Forbidden` response. This link is persistent and does not expire, but requires an active session to resolve.",
                "example": "https://app.asana.com/app/asana/-/get_asset?asset_id=1234567890",
                "format": "uri",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "size": {
                "description": "The size of the attachment in bytes. Only present when the `resource_subtype` is `asana`.",
                "example": 12345,
                "readOnly": true,
                "type": "integer"
              },
              "view_url": {
                "description": "The URL where the attachment can be viewed, which may be friendlier to users in a browser than just directing them to a raw file. May be null if no view URL exists for the service.",
                "example": "https://www.dropbox.com/s/123/Screenshot.png",
                "format": "uri",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "AuditLogEvent": {
        "description": "An object representing a single event within an Asana domain.\n\nEvery audit log event is comprised of an `event_type`, `actor`, `resource`, and `context`. Some events will include additional metadata about the event under `details`. See our [currently supported list of events](/docs/audit-log-events#supported-audit-log-events) for more details.",
        "properties": {
          "actor": {
            "$ref": "#/components/schemas/AuditLogEventActor"
          },
          "context": {
            "$ref": "#/components/schemas/AuditLogEventContext"
          },
          "created_at": {
            "description": "The time the event was created.",
            "example": "2021-01-01T00:00:00.000Z",
            "format": "date-time",
            "type": "string"
          },
          "details": {
            "$ref": "#/components/schemas/AuditLogEventDetails"
          },
          "event_category": {
            "description": "The category that this `event_type` belongs to.",
            "example": "deletion",
            "type": "string"
          },
          "event_type": {
            "description": "The type of the event.",
            "example": "task_deleted",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the `AuditLogEvent`, as a string.",
            "example": "12345",
            "type": "string",
            "x-insert-after": false
          },
          "resource": {
            "$ref": "#/components/schemas/AuditLogEventResource"
          }
        },
        "type": "object"
      },
      "AuditLogEventActor": {
        "description": "The entity that triggered the event. Will typically be a user.",
        "properties": {
          "actor_type": {
            "description": "The type of actor.\nCan be one of `user`, `asana`, `asana_support`, `anonymous`, `external_administrator`, or `data_retention_policy`.",
            "enum": [
              "user",
              "asana",
              "asana_support",
              "anonymous",
              "external_administrator",
              "data_retention_policy"
            ],
            "example": "user",
            "type": "string"
          },
          "email": {
            "description": "The email of the actor, if it is a user.",
            "example": "gregsanchez@example.com",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the actor, if it is a user.",
            "example": "1111",
            "type": "string"
          },
          "name": {
            "description": "The name of the actor, if it is a user.",
            "example": "Greg Sanchez",
            "type": "string"
          }
        },
        "type": "object"
      },
      "AuditLogEventContext": {
        "description": "The context from which this event originated.",
        "properties": {
          "api_authentication_method": {
            "description": "The authentication method used in the context of an API request.\nOnly present if the `context_type` is `api`. Can be one of `cookie`, `oauth`, `personal_access_token`, or `service_account`.",
            "enum": [
              "cookie",
              "oauth",
              "personal_access_token",
              "service_account"
            ],
            "type": "string"
          },
          "client_ip_address": {
            "description": "The IP address of the client that initiated the event, if applicable.",
            "example": "1.1.1.1",
            "type": "string"
          },
          "context_type": {
            "description": "The type of context.\nCan be one of `web`, `desktop`, `mobile`, `asana_support`, `asana`, `email`, or `api`.",
            "enum": [
              "web",
              "desktop",
              "mobile",
              "asana_support",
              "asana",
              "email",
              "api"
            ],
            "example": "web",
            "type": "string"
          },
          "oauth_app_name": {
            "description": "The name of the OAuth App that initiated the event.\nOnly present if the `api_authentication_method` is `oauth`.",
            "type": "string"
          },
          "on_behalf_of_user_id": {
            "description": "The ID of the user who requested a change via support.",
            "example": 12345,
            "type": "integer"
          },
          "rule_name": {
            "description": "The name of the automation rule that initiated the event.",
            "example": "When Task is added to this project",
            "type": "string"
          },
          "user_agent": {
            "description": "The user agent of the client that initiated the event, if applicable.",
            "example": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36",
            "type": "string"
          }
        },
        "type": "object"
      },
      "AuditLogEventDetails": {
        "additionalProperties": true,
        "description": "Event specific details. The schema will vary depending on the `event_type`.",
        "properties": {
          "group": {
            "additionalProperties": true,
            "description": "The division or organizational unit where the event occurred. Primarily used to scope role change events (e.g., `user_division_admin_role_changed`), but may appear in other contexts involving group-level changes.",
            "type": "object"
          },
          "new_value": {
            "description": "The new value after the modification in the audited event.",
            "nullable": true,
            "type": "string"
          },
          "old_value": {
            "description": "The previous value of the field that was modified in the audited event.",
            "nullable": true,
            "type": "string"
          },
          "saml_response": {
            "description": "The response received from the IdP when a user logs in with SAML SSO. Present on `user_login_failed` and `user_login_succeeded` events.",
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "AuditLogEventResource": {
        "description": "The primary object that was affected by this event.",
        "properties": {
          "email": {
            "description": "The email of the resource, if applicable.",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource.",
            "example": "1111",
            "type": "string"
          },
          "name": {
            "description": "The name of the resource.",
            "example": "Example Task",
            "nullable": true,
            "type": "string"
          },
          "resource_subtype": {
            "description": "The subtype of resource. Most resources will not have a subtype.",
            "example": "milestone",
            "type": "string"
          },
          "resource_type": {
            "description": "The type of resource.",
            "example": "task",
            "type": "string"
          }
        },
        "type": "object"
      },
      "BatchRequest": {
        "description": "A request object for use in a batch request.",
        "properties": {
          "actions": {
            "items": {
              "$ref": "#/components/schemas/BatchRequestAction"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "BatchRequestAction": {
        "description": "An action object for use in a batch request.",
        "properties": {
          "data": {
            "description": "For `GET` requests, this should be a map of query parameters you would have normally passed in the URL. Options and pagination are not accepted here; put them in `options` instead. For `POST`, `PATCH`, and `PUT` methods, this should be the content you would have normally put in the data field of the body.",
            "example": {
              "assignee": "me",
              "workspace": "1337"
            },
            "type": "object"
          },
          "method": {
            "description": "The HTTP method you wish to emulate for the action.",
            "enum": [
              "get",
              "post",
              "put",
              "delete",
              "patch",
              "head"
            ],
            "example": "get",
            "type": "string"
          },
          "options": {
            "description": "Pagination (`limit` and `offset`) and output options (`fields` or `expand`) for the action. “Pretty” JSON output is not an available option on individual actions; if you want pretty output, specify that option on the parent request.",
            "example": {
              "fields": [
                "name",
                "notes",
                "completed"
              ],
              "limit": 3
            },
            "properties": {
              "fields": {
                "description": "The fields to retrieve in the request.",
                "example": [
                  "name",
                  "gid",
                  "notes",
                  "completed"
                ],
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "limit": {
                "description": "Pagination limit for the request.",
                "example": 50,
                "type": "integer"
              },
              "offset": {
                "description": "Pagination offset for the request.",
                "example": "eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9",
                "type": "integer"
              }
            },
            "type": "object"
          },
          "relative_path": {
            "description": "The path of the desired endpoint relative to the API’s base URL. Query parameters are not accepted here; put them in `data` instead.",
            "example": "/tasks/123",
            "type": "string"
          }
        },
        "required": [
          "relative_path",
          "method"
        ],
        "type": "object"
      },
      "BatchResponse": {
        "description": "A response object returned from a batch request.",
        "properties": {
          "body": {
            "description": "The JSON body that the invoked endpoint returned.",
            "example": {
              "data": {
                "completed": false,
                "gid": "1967",
                "name": "Hello, world!",
                "notes": "How are you today?"
              }
            },
            "type": "object"
          },
          "headers": {
            "description": "A map of HTTP headers specific to this result. This is primarily used for returning a `Location` header to accompany a `201 Created` result.  The parent HTTP response will contain all common headers.",
            "example": {
              "location": "/tasks/1234"
            },
            "type": "object"
          },
          "status_code": {
            "description": "The HTTP status code that the invoked endpoint returned.",
            "example": 200,
            "type": "integer"
          }
        },
        "type": "object"
      },
      "BudgetActualRequest": {
        "description": "Defines the configuration of the actual portion of a budget. The actual value represents aggregated time tracking data attributed to the budget’s parent. This object controls which time entries are included based on their billable status. When no entries match the selected filter, the value will be 0.",
        "properties": {
          "billable_status_filter": {
            "description": "Billable status filter applied to time tracking entries contributing to the actual value. Determines which entries are included in aggregation. When not provided, defaults to `billable`.",
            "enum": [
              "billable",
              "non_billable",
              "any"
            ],
            "example": "billable",
            "type": "string"
          }
        },
        "type": "object"
      },
      "BudgetActualResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/BudgetActualRequest"
          },
          {
            "description": "Represents the computed actual portion of a budget. The actual value is derived from time tracking entries attributed to the budget’s parent, filtered according to the specified billable_status_filter. When budget_type is time, it represents minutes; when budget_type is cost, it represents total cost (actual time × resource rate). When no applicable entries exist, value will be 0.",
            "properties": {
              "units": {
                "description": "The units of the actual value. * When `budget_type` is `time`, units are `\"minutes\"`. * When `budget_type` is `cost`, units are the ISO 4217 currency code configured at the domain level.",
                "example": "USD",
                "readOnly": true,
                "type": "string"
              },
              "value": {
                "description": "The aggregated actual value for the budget. * When `budget_type` is `time`, represents the total actual minutes from time tracking entries. * When `budget_type` is `cost`, represents the total actual cost, computed as (actual time × resource rate).",
                "example": 100,
                "readOnly": true,
                "type": "number"
              }
            },
            "type": "object"
          }
        ]
      },
      "BudgetCompact": {
        "description": "A *budget* object represents a budget for a given parent.",
        "properties": {
          "budget_type": {
            "description": "The type of the budget, in \"cost\" or \"time\". The value of this property will dictate how the corresponding values for actual, estimate, and total are interpreted.",
            "enum": [
              "cost",
              "time"
            ],
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "budget",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "BudgetEstimateRequest": {
        "description": "Defines how the estimate portion of a budget is configured. This object controls whether the estimate is enabled, what data source it uses, and which tasks (by billable status) are included in calculating the estimate value. When disabled (enabled: false and source: none), the estimate is hidden and the API response will return `value: null` and `units: null` for this field.",
        "properties": {
          "billable_status_filter": {
            "description": "Billable status filter applied to the estimate when `source` is `tasks`. Ignored when `source` is `capacity_plans` or `none`. When not provided, defaults to `billable`.",
            "enum": [
              "billable",
              "non_billable",
              "any"
            ],
            "type": "string"
          },
          "enabled": {
            "description": "Controls whether the estimate is displayed in the budget. This flag primarily affects UI presentation and the response payload. When `false` (and `source` is `none`), the estimate is hidden and the API response will return `value: null` and `units: null` for this field.",
            "example": true,
            "type": "boolean"
          },
          "source": {
            "description": "The data source for the estimate. `tasks`: use task-level estimated time attributed to the parent. `capacity_plans`: use capacity plan estimates attributed to the parent. `none`: disables the estimate; only valid when `enabled` is `false`. When `enabled` is `true`, `source` must not be `none`.",
            "enum": [
              "none",
              "tasks",
              "capacity_plans"
            ],
            "example": "tasks",
            "type": "string"
          }
        },
        "type": "object"
      },
      "BudgetEstimateResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/BudgetEstimateRequest"
          },
          {
            "description": "Represents the computed estimate portion of a budget. This object includes the calculated estimate value and its corresponding units. The estimate reflects aggregated data from the configured source, and when source is tasks, the specified billable_status_filter determines which tasks contribute. When disabled (enabled: false and source: none), both value and units will be null.",
            "properties": {
              "units": {
                "description": "The units of the estimate value. When `budget_type` is `time`, units are `\"minutes\"`. When `budget_type` is `cost`, units are the ISO 4217 currency code configured at the domain level. When `source` is `none` and `enabled` is `false`, this field will be `null`.",
                "example": "USD",
                "readOnly": true,
                "type": "string"
              },
              "value": {
                "description": "The aggregated estimate value for the budget. This value is computed based on the selected `source` and, when `source` is `tasks`, the specified `billable_status_filter`. When `budget_type` is `time`, represents the aggregated estimated minutes on the parent. When `budget_type` is `cost`, represents the aggregated estimated cost on the parent (estimated time x resource rate). When `source` is `none` and `enabled` is `false`, this field will be `null`.",
                "example": 100,
                "readOnly": true,
                "type": "number"
              }
            },
            "type": "object"
          }
        ]
      },
      "BudgetRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/BudgetCompact"
          },
          {
            "properties": {
              "actual": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/BudgetActualRequest"
                  }
                ]
              },
              "estimate": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/BudgetEstimateRequest"
                  }
                ]
              },
              "parent": {
                "description": "Globally unique ID of the parent object: project. Can only be set on create, immutable thereafter.",
                "example": "181636",
                "type": "string"
              },
              "total": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/BudgetTotalRequest"
                  }
                ]
              }
            },
            "type": "object"
          }
        ]
      },
      "BudgetResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/BudgetCompact"
          },
          {
            "properties": {
              "actual": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/BudgetActualResponse"
                  }
                ]
              },
              "estimate": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/BudgetEstimateResponse"
                  }
                ]
              },
              "parent": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ProjectCompact"
                  },
                  {
                    "type": "object"
                  }
                ]
              },
              "total": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/BudgetTotalResponse"
                  }
                ]
              }
            },
            "type": "object"
          }
        ]
      },
      "BudgetTotalRequest": {
        "description": "Defines how the total portion of a budget is configured. The total represents a user-defined target value, not an aggregated one. This object specifies whether the total is displayed and the current value for the selected budget_type.",
        "properties": {
          "enabled": {
            "description": "Indicates whether the total value is active and should be displayed in the budget. This flag primarily affects UI presentation and the response payload.",
            "example": true,
            "type": "boolean"
          },
          "value": {
            "description": "The user-set value for the total budget. When `budget_type` is `time`, represents minutes. When `budget_type` is `cost`, represents the monetary amount in the domain's currency. This value is stored separately for each `budget_type`, so switching between types preserves each value.",
            "example": 100,
            "type": "number"
          }
        },
        "type": "object"
      },
      "BudgetTotalResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/BudgetTotalRequest"
          },
          {
            "description": "Represents the configured total portion of a budget. The total value is user-defined and may differ for each budget_type. When budget_type is time, it is expressed in minutes; when budget_type is cost, it is expressed in the domain’s ISO 4217 currency code. When enabled is false, both value and units will be null.",
            "properties": {
              "units": {
                "description": "The units of the total value. When `budget_type` is `time`, units are `\"minutes\"`. When `budget_type` is `cost`, units are the ISO 4217 currency code configured at the domain level. When `enabled` is `false`, this field will be `null`.",
                "example": "USD",
                "readOnly": true,
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "CreateMembershipRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/MembershipRequest"
          },
          {
            "properties": {
              "member": {
                "description": "The gid of the user or team.",
                "example": 12345,
                "type": "string"
              },
              "parent": {
                "description": "The gid of the `goal`, `project`, `portfolio`, `custom_type`, `custom_field`, `table`, or `record` to add the member to.",
                "example": "987654",
                "type": "string"
              },
              "role": {
                "deprecated": true,
                "description": "*Deprecated: new integrations should use access_level* The role given to the member. Optional argument, will default to `commenter` for goals and the default project role for projects. Can be `editor` or `commenter` for goals. Can be `admin`,`editor` or `commenter` for projects.",
                "example": "editor",
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "CreateTimeTrackingEntryRequest": {
        "properties": {
          "assignee": {
            "description": "*Optional*. The gid of the user this entry's logged time is attributed to. Defaults to the current user; can only be set to another user if you're their time reviewer or an admin. Reviewer-submitter relationships require the Timesheets and Budgets add-on.",
            "example": "12345",
            "type": "string"
          },
          "attributable_to": {
            "description": "*Optional*. The gid of the project which the time is attributable to.",
            "example": "987654",
            "type": "string"
          },
          "billable_status": {
            "description": "*Optional*. The current billable status of the entry. This field requires the Timesheets and Budgets add-on; including it without the add-on returns a `402 Payment Required` error.",
            "enum": [
              "billable",
              "nonBillable",
              "notApplicable"
            ],
            "example": "billable",
            "type": "string"
          },
          "categories": {
            "description": "*Optional*. The gids of time tracking categories to assign to this time tracking entry. Existing categories will be overridden. Currently limited to a maximum of 1 category. This field requires the Timesheets and Budgets add-on; including it without the add-on returns a `402 Payment Required` error.",
            "example": [
              "12345"
            ],
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "description": {
            "description": "*Optional*. The description of the entry. This field requires the Timesheets and Budgets add-on; including it without the add-on returns a `402 Payment Required` error.",
            "example": "My description of work done on this entry",
            "type": "string"
          },
          "duration_minutes": {
            "description": "Time in minutes tracked by the entry. Must be greater than 0",
            "example": 12,
            "type": "integer"
          },
          "entered_on": {
            "description": "*Optional*. The day that this entry is logged on. Defaults to today if not specified",
            "example": "2023-03-19",
            "format": "date",
            "type": "string"
          }
        },
        "type": "object"
      },
      "CreateTimesheetApprovalStatusRequest": {
        "description": "A request to create a timesheet approval status.",
        "properties": {
          "end_date": {
            "description": "The end date of the timesheet week (must be the following Sunday for Monday starts, or the following Saturday for Sunday starts).",
            "example": "2025-01-12",
            "format": "date",
            "type": "string"
          },
          "start_date": {
            "description": "The start date of the timesheet week (must be a Monday or Sunday).",
            "example": "2025-01-06",
            "format": "date",
            "type": "string"
          },
          "user": {
            "description": "Globally unique identifier for the user whose timesheet this is.",
            "example": "12345",
            "type": "string"
          },
          "workspace": {
            "description": "Globally unique identifier for the workspace.",
            "example": "12345",
            "type": "string"
          }
        },
        "required": [
          "user",
          "workspace",
          "start_date",
          "end_date"
        ],
        "type": "object"
      },
      "CustomFieldBase": {
        "allOf": [
          {
            "$ref": "#/components/schemas/CustomFieldCompact"
          },
          {
            "properties": {
              "asana_created_field": {
                "description": "*Conditional*. A unique identifier to associate this field with the template source of truth.",
                "enum": [
                  "a_v_requirements",
                  "account_name",
                  "actionable",
                  "align_shipping_link",
                  "align_status",
                  "allotted_time",
                  "appointment",
                  "approval_stage",
                  "approved",
                  "article_series",
                  "board_committee",
                  "browser",
                  "campaign_audience",
                  "campaign_project_status",
                  "campaign_regions",
                  "channel_primary",
                  "client_topic_type",
                  "complete_by",
                  "contact",
                  "contact_email_address",
                  "content_channels",
                  "content_channels_needed",
                  "content_stage",
                  "content_type",
                  "contract",
                  "contract_status",
                  "cost",
                  "creation_stage",
                  "creative_channel",
                  "creative_needed",
                  "creative_needs",
                  "data_sensitivity",
                  "deal_size",
                  "delivery_appt",
                  "delivery_appt_date",
                  "department",
                  "department_responsible",
                  "design_request_needed",
                  "design_request_type",
                  "discussion_category",
                  "do_this_task",
                  "editorial_content_status",
                  "editorial_content_tag",
                  "editorial_content_type",
                  "effort",
                  "effort_level",
                  "est_completion_date",
                  "estimated_time",
                  "estimated_value",
                  "expected_cost",
                  "external_steps_needed",
                  "favorite_idea",
                  "feedback_type",
                  "financial",
                  "funding_amount",
                  "grant_application_process",
                  "hiring_candidate_status",
                  "idea_status",
                  "ids_link",
                  "ids_patient_link",
                  "implementation_stage",
                  "insurance",
                  "interview_area",
                  "interview_question_score",
                  "itero_scan_link",
                  "job_s_applied_to",
                  "lab",
                  "launch_status",
                  "lead_status",
                  "localization_language",
                  "localization_market_team",
                  "localization_status",
                  "meeting_minutes",
                  "meeting_needed",
                  "minutes",
                  "mrr",
                  "must_localize",
                  "name_of_foundation",
                  "need_to_follow_up",
                  "next_appointment",
                  "next_steps_sales",
                  "num_people",
                  "number_of_user_reports",
                  "office_location",
                  "onboarding_activity",
                  "owner",
                  "participants_needed",
                  "patient_date_of_birth",
                  "patient_email",
                  "patient_phone",
                  "patient_status",
                  "phone_number",
                  "planning_category",
                  "point_of_contact",
                  "position",
                  "post_format",
                  "prescription",
                  "priority",
                  "priority_level",
                  "product",
                  "product_stage",
                  "progress",
                  "project_size",
                  "project_status",
                  "proposed_budget",
                  "publish_status",
                  "reason_for_scan",
                  "referral",
                  "request_type",
                  "research_status",
                  "responsible_department",
                  "responsible_team",
                  "risk_assessment_status",
                  "room_name",
                  "sales_counterpart",
                  "sentiment",
                  "shipping_link",
                  "social_channels",
                  "stage",
                  "status",
                  "status_design",
                  "status_of_initiative",
                  "system_setup",
                  "task_progress",
                  "team",
                  "team_marketing",
                  "team_responsible",
                  "time_it_takes_to_complete_tasks",
                  "timeframe",
                  "treatment_type",
                  "type_work_requests_it",
                  "use_agency",
                  "user_name",
                  "vendor_category",
                  "vendor_type",
                  "word_count",
                  null
                ],
                "example": "priority",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "currency_code": {
                "description": "ISO 4217 currency code to format this custom field. This will be null if the `format` is not `currency`.",
                "example": "EUR",
                "nullable": true,
                "type": "string"
              },
              "custom_label": {
                "description": "This is the string that appears next to the custom field value. This will be null if the `format` is not `custom`.",
                "example": "gold pieces",
                "nullable": true,
                "type": "string"
              },
              "custom_label_position": {
                "description": "Only relevant for custom fields with `custom` format. This depicts where to place the custom label. This will be null if the `format` is not `custom`.",
                "enum": [
                  "prefix",
                  "suffix",
                  null
                ],
                "example": "suffix",
                "nullable": true,
                "type": "string"
              },
              "description": {
                "description": "[Opt In](/docs/inputoutput-options). The description of the custom field.",
                "example": "Development team priority",
                "type": "string"
              },
              "enum_options": {
                "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                "items": {
                  "$ref": "#/components/schemas/EnumOption"
                },
                "type": "array"
              },
              "format": {
                "description": "The format of this custom field.",
                "enum": [
                  "currency",
                  "identifier",
                  "percentage",
                  "custom",
                  "duration",
                  "none"
                ],
                "example": "custom",
                "type": "string"
              },
              "has_notifications_enabled": {
                "description": "*Conditional*. This flag describes whether a follower of a task with this field should receive inbox notifications from changes to this field.",
                "example": true,
                "type": "boolean"
              },
              "is_global_to_workspace": {
                "description": "This flag describes whether this custom field is available to every container in the workspace. Before project-specific custom fields, this field was always true.",
                "example": true,
                "readOnly": true,
                "type": "boolean"
              },
              "precision": {
                "description": "Only relevant for custom fields of type `Number`. This field dictates the number of places after the decimal to round to, i.e. 0 is integer values, 1 rounds to the nearest tenth, and so on. Must be between 0 and 6, inclusive.\nFor percentage format, this may be unintuitive, as a value of 0.25 has a precision of 0, while a value of 0.251 has a precision of 1. This is due to 0.25 being displayed as 25%.\nThe identifier format will always have a precision of 0.",
                "example": 2,
                "type": "integer"
              }
            },
            "type": "object"
          }
        ]
      },
      "CustomFieldCompact": {
        "description": "Custom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.",
        "properties": {
          "date_value": {
            "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
            "nullable": true,
            "properties": {
              "date": {
                "description": "A string representing the date in YYYY-MM-DD format.",
                "example": "2024-08-23",
                "type": "string"
              },
              "date_time": {
                "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                "example": "2024-08-23T22:00:00.000Z",
                "type": "string"
              }
            },
            "type": "object"
          },
          "display_value": {
            "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
            "example": "blue",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "enabled": {
            "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
            "example": true,
            "readOnly": true,
            "type": "boolean"
          },
          "enum_options": {
            "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
            "items": {
              "$ref": "#/components/schemas/EnumOption"
            },
            "type": "array"
          },
          "enum_value": {
            "allOf": [
              {
                "$ref": "#/components/schemas/EnumOption"
              },
              {
                "description": "*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                "type": "object"
              }
            ],
            "nullable": true
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "id_prefix": {
            "description": "This field is the unique custom ID string for the custom field.",
            "example": "ID",
            "nullable": true,
            "type": "string"
          },
          "input_restrictions": {
            "example": [
              "task"
            ],
            "items": {
              "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
              "enum": [
                "task",
                "project",
                "portfolio",
                "goal"
              ],
              "type": "string"
            },
            "type": "array"
          },
          "is_formula_field": {
            "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
            "example": false,
            "type": "boolean"
          },
          "is_lookup_field": {
            "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
            "example": false,
            "type": "boolean"
          },
          "multi_enum_values": {
            "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
            "items": {
              "$ref": "#/components/schemas/EnumOption"
            },
            "type": "array"
          },
          "name": {
            "description": "The name of the custom field.",
            "example": "Status",
            "type": "string"
          },
          "number_value": {
            "description": "*Conditional*. This number is the value of a `number` custom field.",
            "example": 5.2,
            "nullable": true,
            "type": "number"
          },
          "representation_type": {
            "description": "This field tells the type of the custom field.",
            "enum": [
              "text",
              "enum",
              "multi_enum",
              "number",
              "date",
              "people",
              "formula",
              "custom_id",
              "reference"
            ],
            "example": "number",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "custom_field",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "text_value": {
            "description": "*Conditional*. This string is the value of a `text` custom field.",
            "example": "Some Value",
            "nullable": true,
            "type": "string"
          },
          "type": {
            "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
            "enum": [
              "text",
              "enum",
              "multi_enum",
              "number",
              "date",
              "people",
              "reference"
            ],
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "CustomFieldCreateRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/CustomFieldRequest"
          },
          {
            "properties": {
              "resource_subtype": {
                "description": "The type of the custom field. Must be one of the given values.",
                "enum": [
                  "text",
                  "enum",
                  "multi_enum",
                  "number",
                  "date",
                  "people",
                  "reference"
                ],
                "example": "text",
                "type": "string"
              }
            },
            "required": [
              "resource_subtype"
            ],
            "type": "object"
          }
        ]
      },
      "CustomFieldMembershipBase": {
        "$ref": "#/components/schemas/CustomFieldMembershipCompact"
      },
      "CustomFieldMembershipCompact": {
        "description": "This object describes a user or team's membership to a custom field including their level of access (Admin, Editor, or User).",
        "properties": {
          "access_level": {
            "description": "Whether the member has admin, editor, or user access to the custom field.",
            "enum": [
              "admin",
              "editor",
              "user"
            ],
            "example": "admin",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "$ref": "#/components/schemas/MemberCompact",
            "description": "Member can be a user or a team."
          },
          "parent": {
            "$ref": "#/components/schemas/CustomFieldCompact",
            "description": "The custom field the user or team is a member of."
          },
          "resource_subtype": {
            "description": "Type of the membership.",
            "example": "custom_field_membership",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "custom_field_membership",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "CustomFieldMembershipResponse": {
        "$ref": "#/components/schemas/CustomFieldMembershipBase"
      },
      "CustomFieldRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/CustomFieldBase"
          },
          {
            "properties": {
              "owned_by_app": {
                "description": "*Allow-listed*. Instructs the API that this Custom Field is app-owned. This parameter is allow-listed to specific apps at this point in time. For apps that are not allow-listed, providing this parameter will result in a `403 Forbidden`.",
                "type": "boolean"
              },
              "people_value": {
                "description": "*Conditional*. Only relevant for custom fields of type `people`. This array of user GIDs, emails, or the string \"me\", reflects the users to be written to a `people` custom field. Note that *write* operations will replace existing users (if any) in the custom field with the users specified in this array.",
                "example": [
                  "12345"
                ],
                "items": {
                  "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
                  "type": "string"
                },
                "type": "array"
              },
              "reference_value": {
                "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of GIDs reflects the objects to be written to a `reference` custom field. Note that *write* operations will replace existing objects (if any) in the custom field with the objects specified in this array.",
                "example": [
                  "12345"
                ],
                "items": {
                  "description": "The GID of an object.",
                  "type": "string"
                },
                "type": "array"
              },
              "workspace": {
                "description": "*Create-Only* The workspace to create a custom field in.",
                "example": "1331",
                "type": "string"
              }
            },
            "required": [
              "workspace"
            ],
            "type": "object"
          }
        ]
      },
      "CustomFieldResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/CustomFieldBase"
          },
          {
            "properties": {
              "created_by": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/UserCompact"
                  },
                  {}
                ],
                "nullable": true
              },
              "default_access_level": {
                "description": "The default access level when inviting new members to the custom field. This isn't applied when the `privacy_setting` is `private`, or the user is a guest. For local fields in a project or portfolio, the user must additionally have permission to modify the container itself.",
                "enum": [
                  "admin",
                  "editor",
                  "user"
                ],
                "example": "user",
                "type": "string"
              },
              "html_text_value": {
                "description": "*Conditional*. Only relevant for custom fields of type `text`. This is the HTML representation of the text value of a custom field, corresponding to the `text_value` plain-text field. See [rich text](/docs/rich-text#reading-rich-text).",
                "example": "<body>Some Value</body>",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "id_prefix": {
                "description": "This field is the unique custom ID string for the custom field.",
                "example": "ID",
                "nullable": true,
                "type": "string"
              },
              "input_restrictions": {
                "example": [
                  "task"
                ],
                "items": {
                  "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                  "enum": [
                    "task",
                    "project",
                    "portfolio",
                    "goal"
                  ],
                  "type": "string"
                },
                "type": "array"
              },
              "is_formula_field": {
                "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                "example": false,
                "type": "boolean"
              },
              "is_lookup_field": {
                "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                "example": false,
                "type": "boolean"
              },
              "is_value_read_only": {
                "description": "*Conditional*. This flag describes whether a custom field is read only.",
                "example": false,
                "type": "boolean"
              },
              "people_value": {
                "description": "*Conditional*. Only relevant for custom fields of type `people`. This array of [compact user](/reference/users) objects reflects the values of a `people` custom field.",
                "items": {
                  "$ref": "#/components/schemas/UserCompact"
                },
                "type": "array"
              },
              "privacy_setting": {
                "description": "The privacy setting of the custom field. *Note: Administrators in your organization may restrict the values of `privacy_setting`.*",
                "enum": [
                  "public_with_guests",
                  "public",
                  "private"
                ],
                "example": "public_with_guests",
                "type": "string"
              },
              "reference_value": {
                "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of objects reflects the values of a `reference` custom field.",
                "items": {
                  "$ref": "#/components/schemas/AsanaNamedResource"
                },
                "type": "array"
              },
              "representation_type": {
                "description": "This field tells the type of the custom field.",
                "enum": [
                  "text",
                  "enum",
                  "multi_enum",
                  "number",
                  "date",
                  "people",
                  "formula",
                  "custom_id",
                  "reference"
                ],
                "example": "number",
                "readOnly": true,
                "type": "string"
              },
              "resource_subtype": {
                "description": "The type of the custom field. Must be one of the given values.\n",
                "enum": [
                  "text",
                  "enum",
                  "multi_enum",
                  "number",
                  "date",
                  "people",
                  "reference"
                ],
                "example": "text",
                "readOnly": true,
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "CustomFieldSettingBase": {
        "$ref": "#/components/schemas/CustomFieldSettingCompact"
      },
      "CustomFieldSettingCompact": {
        "description": "Custom Fields Settings objects represent the many-to-many join of the Custom Field and Project as well as stores information that is relevant to that particular pairing.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "custom_field_setting",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "CustomFieldSettingResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/CustomFieldSettingBase"
          },
          {
            "properties": {
              "custom_field": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/CustomFieldResponse"
                  },
                  {
                    "description": "The custom field that is applied to the `parent`.",
                    "readOnly": true,
                    "type": "object"
                  }
                ]
              },
              "is_important": {
                "description": "`is_important` is used in the Asana web application to determine if this custom field is displayed in the list/grid view of a project or portfolio.",
                "example": false,
                "readOnly": true,
                "type": "boolean"
              },
              "parent": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ProjectCompact"
                  },
                  {
                    "description": "The parent to which the custom field is applied. This can be a project or portfolio and indicates that the tasks or projects that the parent contains may be given custom field values for this custom field.",
                    "readOnly": true,
                    "type": "object"
                  }
                ]
              },
              "project": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ProjectCompact"
                  },
                  {
                    "description": "*Deprecated: new integrations should prefer the `parent` field.* The id of the project that this custom field settings refers to.",
                    "readOnly": true,
                    "type": "object"
                  }
                ]
              }
            },
            "type": "object"
          }
        ]
      },
      "CustomFieldTableSettingBase": {
        "$ref": "#/components/schemas/CustomFieldTableSettingCompact"
      },
      "CustomFieldTableSettingCompact": {
        "description": "A *custom field table setting* represents the many-to-many join of a custom field and a table, storing information relevant to that particular pairing.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "custom_field_setting",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "CustomFieldTableSettingResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/CustomFieldTableSettingBase"
          },
          {
            "properties": {
              "custom_field": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/CustomFieldCompact"
                  },
                  {
                    "description": "The custom field that is applied to the table.",
                    "readOnly": true,
                    "type": "object"
                  }
                ]
              },
              "is_important": {
                "description": "`is_important` is used in the Asana web application to determine if this custom field is displayed in the list/grid view of a table.",
                "readOnly": true,
                "type": "boolean"
              }
            },
            "type": "object"
          }
        ]
      },
      "CustomTypeBase": {
        "$ref": "#/components/schemas/CustomTypeCompact"
      },
      "CustomTypeCompact": {
        "description": "<p><strong style={{ color: \"#4573D2\" }}>Full object requires scope: </strong><code>custom_types:read</code></p>\n\nCustom Types extend the types of Asana Objects.",
        "properties": {
          "asana_created_type_identifier": {
            "description": "*Read-only*. A stable identifier present when this custom type was created by Asana as part of an Asana product (for example, a Command ticket type or a Service queue type). `null` for custom types created by users, and for Asana-created types that do not have a public identifier yet. New values may be added over time as Asana products introduce new types; integrations should tolerate unrecognized values.",
            "enum": [
              "COMMAND_TICKET",
              "COMMAND_RELEASE",
              "COMMAND_TEAMSPACE",
              "SERVICE_TICKET",
              "SERVICE_CONVERSATION",
              "SERVICE_QUEUE"
            ],
            "example": "COMMAND_TICKET",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the custom type.",
            "example": "Bug ticket",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "custom_type",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "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).",
        "properties": {
          "access_level": {
            "description": "Whether the member has admin, editor, user, or viewer access to the custom type.",
            "enum": [
              "admin",
              "editor",
              "user",
              "viewer"
            ],
            "example": "admin",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "$ref": "#/components/schemas/MemberCompact",
            "description": "Member can be a user or a team."
          },
          "parent": {
            "$ref": "#/components/schemas/CustomTypeCompact",
            "description": "The custom type the user or team is a member of."
          },
          "resource_subtype": {
            "description": "Type of the membership.",
            "example": "custom_type_membership",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "custom_type_membership",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "CustomTypeMembershipResponse": {
        "$ref": "#/components/schemas/CustomTypeMembershipBase"
      },
      "CustomTypeResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/CustomTypeBase"
          },
          {
            "properties": {
              "status_options": {
                "description": "The available options for the custom type.",
                "items": {
                  "$ref": "#/components/schemas/CustomTypeStatusOptionResponse"
                },
                "nullable": true,
                "type": "array"
              }
            },
            "type": "object"
          }
        ]
      },
      "CustomTypeStatusOptionBase": {
        "$ref": "#/components/schemas/CustomTypeStatusOptionCompact"
      },
      "CustomTypeStatusOptionCompact": {
        "description": "<p><strong style={{ color: \"#4573D2\" }}>Full object requires scope: </strong><code>custom_types:read</code></p>\n\nA generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the custom type status option.",
            "example": "Solution pending",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "custom_type_status_option",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "CustomTypeStatusOptionResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/CustomTypeStatusOptionBase"
          },
          {
            "properties": {
              "color": {
                "description": "The color associated with the custom type status option. Defaults to ‘none’.",
                "example": "blue",
                "nullable": true,
                "type": "string"
              },
              "completion_state": {
                "description": "The completion state the custom type status option corresponds to, all custom types must have one ‘Incomplete’ and ‘Complete’ status option.",
                "example": "Incomplete",
                "nullable": true,
                "type": "string"
              },
              "enabled": {
                "description": "Whether or not the custom type status option is a selectable value for the custom type.",
                "example": true,
                "nullable": true,
                "type": "boolean"
              }
            },
            "type": "object"
          }
        ]
      },
      "DateVariableCompact": {
        "properties": {
          "description": {
            "description": "The description of what the date variable is used for when instantiating a project.",
            "example": "Choose a start date for your project.",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the date field in the project template. A value of `1` refers to the project start date, while `2` refers to the project due date.",
            "example": "1",
            "readOnly": true,
            "type": "string"
          },
          "name": {
            "description": "The name of the date variable.",
            "example": "Start Date",
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "DateVariableRequest": {
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the date field in the project template. A value of `1` refers to the project start date, while `2` refers to the project due date.",
            "example": "1",
            "type": "string"
          },
          "value": {
            "description": "The date with which the date variable should be replaced when instantiating a project. This takes a date with `YYYY-MM-DD` format.",
            "example": "2022-01-01",
            "format": "date-time",
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "DeprecatedPortfolioMembershipBase": {
        "$ref": "#/components/schemas/DeprecatedPortfolioMembershipCompact"
      },
      "DeprecatedPortfolioMembershipCompact": {
        "description": "This object determines if a user is a member of a portfolio.",
        "properties": {
          "access_level": {
            "description": "Whether the member has admin, editor, or viewer access to the portfolio. Portfolios do not support commenter access yet.",
            "enum": [
              "admin",
              "editor",
              "viewer"
            ],
            "example": "admin",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "portfolio": {
            "$ref": "#/components/schemas/PortfolioCompact",
            "description": "[Opt In](/docs/inputoutput-options). The portfolio the user is a member of."
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "portfolio_membership",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "user": {
            "$ref": "#/components/schemas/UserCompact"
          }
        },
        "type": "object"
      },
      "DeprecatedPortfolioMembershipResponse": {
        "$ref": "#/components/schemas/DeprecatedPortfolioMembershipBase"
      },
      "EffectiveTaskMembership": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TaskMembership"
          },
          {
            "properties": {
              "is_inherited": {
                "description": "Whether this membership is inherited from an ancestor task (`true`) or is a direct membership (`false`).",
                "example": false,
                "type": "boolean"
              }
            },
            "type": "object"
          }
        ],
        "description": "A task's project membership, indicating whether the membership is direct or inherited from an ancestor task."
      },
      "EmptyResponse": {
        "description": "An empty object. Some endpoints do not return an object on success. The success is conveyed through a 2-- status code and returning an empty object.",
        "type": "object"
      },
      "EnumOption": {
        "description": "Enum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
        "properties": {
          "color": {
            "description": "The color of the enum option. Defaults to `none`.",
            "example": "blue",
            "type": "string"
          },
          "enabled": {
            "description": "Whether or not the enum option is a selectable value for the custom field.",
            "example": true,
            "type": "boolean"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the enum option.",
            "example": "Low",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "enum_option",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "EnumOptionBase": {
        "$ref": "#/components/schemas/EnumOption"
      },
      "EnumOptionInsertRequest": {
        "properties": {
          "after_enum_option": {
            "description": "An existing enum option within this custom field after which the new enum option should be inserted. Cannot be provided together with before_enum_option.",
            "example": "12345",
            "type": "string"
          },
          "before_enum_option": {
            "description": "An existing enum option within this custom field before which the new enum option should be inserted. Cannot be provided together with after_enum_option.",
            "example": "12345",
            "type": "string"
          },
          "enum_option": {
            "description": "The gid of the enum option to relocate.",
            "example": "97285",
            "type": "string"
          }
        },
        "required": [
          "enum_option"
        ],
        "type": "object"
      },
      "EnumOptionRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/EnumOptionBase"
          },
          {
            "properties": {
              "insert_after": {
                "description": "An existing enum option within this custom field after which the new enum option should be inserted. Cannot be provided together with before_enum_option.",
                "example": "12345",
                "type": "string"
              },
              "insert_before": {
                "description": "An existing enum option within this custom field before which the new enum option should be inserted. Cannot be provided together with after_enum_option.",
                "example": "12345",
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "Error": {
        "properties": {
          "help": {
            "description": "Additional information directing developers to resources on how to address and fix the problem, if available.",
            "example": "For more information on API status codes and how to handle them, read the docs on errors: https://asana.github.io/developer-docs/#errors'",
            "readOnly": true,
            "type": "string"
          },
          "message": {
            "description": "Message providing more detail about the error that occurred, if available.",
            "example": "project: Missing input",
            "readOnly": true,
            "type": "string"
          },
          "phrase": {
            "description": "*500 errors only*. A unique error phrase which can be used when contacting developer support to help identify the exact occurrence of the problem in Asana's logs.",
            "example": "6 sad squid snuggle softly",
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "ErrorResponse": {
        "description": "Sadly, sometimes requests to the API are not successful. Failures can\noccur for a wide range of reasons. In all cases, the API should return\nan HTTP Status Code that indicates the nature of the failure,\nwith a response body in JSON format containing additional information.\n\n\nIn the event of a server error the response body will contain an error\nphrase. These phrases are automatically generated using the\n[node-asana-phrase\nlibrary](https://github.com/Asana/node-asana-phrase) and can be used by\nAsana support to quickly look up the incident that caused the server\nerror.",
        "properties": {
          "errors": {
            "items": {
              "$ref": "#/components/schemas/Error"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "EventResponse": {
        "description": "An *event* is an object representing a change to a resource that was\nobserved by an event subscription or delivered asynchronously to\nthe target location of an active webhook.\n\nThe event may be triggered by a different `user` than the\nsubscriber. For example, if user A subscribes to a task and user B\nmodified it, the event's user will be user B. Note: Some events\nare generated by the system, and will have `null` as the user. API\nconsumers should make sure to handle this case.\n\nThe `resource` that triggered the event may be different from the one\nthat the events were requested for or the webhook is subscribed to. For\nexample, a subscription to a project will contain events for tasks\ncontained within the project.\n\n**Note:** pay close attention to the relationship between the fields\n`Event.action` and `Event.change.action`.\n`Event.action` represents the action taken on the resource\nitself, and `Event.change.action` represents how the information\nwithin the resource's fields have been modified.\n\nFor instance, consider these scenarios:\n\n\n* When at task is added to a project, `Event.action` will be\n`added`, `Event.parent` will be an object with the `id` and\n`type` of the project, and there will be no `change` field.\n\n\n* When an assignee is set on the task, `Event.parent` will be\n`null`, `Event.action` will be `changed`,\n`Event.change.action` will be `changed`, and `new_value` will\nbe an object with the user's `id` and `type`.\n\n\n* When a collaborator is added to the task, `Event.parent` will\nbe `null`, `Event.action` will be `changed`,\n`Event.change.action` will be `added`, and `added_value` will be\nan object with the user's `id` and `type`.",
        "properties": {
          "action": {
            "description": "The type of action taken on the **resource** that triggered the event.  This can be one of `changed`, `added`, `removed`, `deleted`, or `undeleted` depending on the nature of the event.",
            "example": "changed",
            "readOnly": true,
            "type": "string"
          },
          "change": {
            "description": "Information about the type of change that has occurred. This field is only present when the value of the property `action`, describing the action taken on the **resource**, is `changed`.",
            "properties": {
              "action": {
                "description": "The type of action taken on the **field** which has been changed.  This can be one of `changed`, `added`, or `removed` depending on the nature of the change.",
                "example": "changed",
                "readOnly": true,
                "type": "string"
              },
              "added_value": {
                "description": "*Conditional.* This property is only present when the value of the event's `change.action` is `added` _and_ the `added_value` is an Asana resource. This will be only the `gid` and `resource_type` of the resource when the events come from webhooks; this will be the compact representation (and can have fields expanded with [opt_fields](/docs/inputoutput-options)) when using the [get events](/reference/getevents) endpoint.",
                "example": {
                  "gid": "12345",
                  "resource_type": "user"
                }
              },
              "field": {
                "description": "The name of the field that has changed in the resource.",
                "example": "assignee",
                "readOnly": true,
                "type": "string"
              },
              "new_value": {
                "description": "*Conditional.* This property is only present when the value of the event's `change.action` is `changed` _and_ the `new_value` is an Asana resource. This will be only the `gid` and `resource_type` of the resource when the events come from webhooks; this will be the compact representation (and can have fields expanded with [opt_fields](/docs/inputoutput-options)) when using the [get events](/reference/getevents) endpoint.",
                "example": {
                  "gid": "12345",
                  "resource_type": "user"
                }
              },
              "removed_value": {
                "description": "*Conditional.* This property is only present when the value of the event's `change.action` is `removed` _and_ the `removed_value` is an Asana resource. This will be only the `gid` and `resource_type` of the resource when the events come from webhooks; this will be the compact representation (and can have fields expanded with [opt_fields](/docs/inputoutput-options)) when using the [get events](/reference/getevents) endpoint.",
                "example": {
                  "gid": "12345",
                  "resource_type": "user"
                }
              }
            },
            "readOnly": true,
            "type": "object"
          },
          "created_at": {
            "description": "The timestamp when the event occurred.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "parent": {
            "allOf": [
              {
                "$ref": "#/components/schemas/AsanaNamedResource"
              },
              {
                "description": "For added/removed events, the parent object that resource was added to or removed from. The parent will be `null` for other event types."
              }
            ]
          },
          "resource": {
            "allOf": [
              {
                "$ref": "#/components/schemas/AsanaNamedResource"
              },
              {
                "description": "The resource which has triggered the event by being modified in some way."
              }
            ]
          },
          "type": {
            "description": "*Deprecated: Refer to the resource_type of the resource.* The type of the resource that generated the event.",
            "example": "task",
            "readOnly": true,
            "type": "string"
          },
          "user": {
            "allOf": [
              {
                "$ref": "#/components/schemas/UserCompact"
              },
              {
                "description": "The user who triggered the event."
              }
            ]
          }
        },
        "type": "object"
      },
      "GoalAddSubgoalRequest": {
        "properties": {
          "insert_after": {
            "description": "An id of a subgoal of this parent goal. The new subgoal will be added after the one specified here. `insert_before` and `insert_after` parameters cannot both be specified.",
            "example": "1331",
            "type": "string"
          },
          "insert_before": {
            "description": "An id of a subgoal of this parent goal. The new subgoal will be added before the one specified here. `insert_before` and `insert_after` parameters cannot both be specified.",
            "example": "1331",
            "type": "string"
          },
          "subgoal": {
            "description": "The goal gid to add as subgoal to a parent goal",
            "example": "1331",
            "type": "string"
          }
        },
        "required": [
          "subgoal"
        ],
        "type": "object"
      },
      "GoalAddSupportingRelationshipRequest": {
        "properties": {
          "contribution_weight": {
            "description": "Defines how much the supporting goal’s progress contributes to the parent goal’s overall progress. When used with automatically calculated [Goal Metrics](/reference/creategoalmetric) (such as `progress_source = subgoal_progress`), this value must be greater than 0 for the subgoal to count toward the parent goal’s progress.\nAccepts a number between 0 and 1 (inclusive). Defaults to `0`.",
            "example": 0,
            "type": "number"
          },
          "insert_after": {
            "description": "An id of a subgoal of this parent goal. The new subgoal will be added after the one specified here. `insert_before` and `insert_after` parameters cannot both be specified. Currently only supported when adding a subgoal.",
            "example": "1331",
            "type": "string"
          },
          "insert_before": {
            "description": "An id of a subgoal of this parent goal. The new subgoal will be added before the one specified here. `insert_before` and `insert_after` parameters cannot both be specified. Currently only supported when adding a subgoal.",
            "example": "1331",
            "type": "string"
          },
          "supporting_resource": {
            "description": "The gid of the supporting resource to add to the parent goal. Must be the gid of a goal, project, task, or portfolio.",
            "example": "12345",
            "type": "string"
          }
        },
        "required": [
          "supporting_resource"
        ],
        "type": "object"
      },
      "GoalAddSupportingWorkRequest": {
        "properties": {
          "supporting_work": {
            "description": "The project/task/portfolio gid to add as supporting work for a goal",
            "example": "1331",
            "type": "string"
          }
        },
        "required": [
          "supporting_work"
        ],
        "type": "object"
      },
      "GoalBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "due_on": {
            "description": "The localized day on which this goal is due. This takes a date with format `YYYY-MM-DD`.",
            "example": "2019-09-15",
            "nullable": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_notes": {
            "description": "The notes of the goal with formatting as HTML. See [rich text](/docs/rich-text).",
            "example": "<body>Start building brand awareness.</body>",
            "type": "string"
          },
          "is_workspace_level": {
            "description": "*Conditional*. This property is only present when the `workspace` provided is an organization. Whether the goal belongs to the `workspace` (and is listed as part of the workspace’s goals) or not. If it isn’t a workspace-level goal, it is a team-level goal, and is associated with the goal’s team.",
            "example": true,
            "type": "boolean"
          },
          "liked": {
            "description": "True if the goal is liked by the authorized user, false if not.",
            "example": false,
            "type": "boolean"
          },
          "name": {
            "description": "The name of the goal.",
            "example": "Grow web traffic by 30%",
            "type": "string"
          },
          "notes": {
            "description": "Free-form textual information associated with the goal (i.e. its description).",
            "example": "Start building brand awareness.",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "goal",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_on": {
            "description": "The day on which work for this goal begins, or null if the goal has no start date. This takes a date with `YYYY-MM-DD` format, and cannot be set unless there is an accompanying due date.",
            "example": "2019-09-14",
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "GoalCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the goal.",
            "example": "Grow web traffic by 30%",
            "type": "string"
          },
          "owner": {
            "allOf": [
              {
                "$ref": "#/components/schemas/UserCompact"
              },
              {
                "type": "object"
              }
            ],
            "nullable": true
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "goal",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "GoalMembershipBase": {
        "description": "This object represents a user's connection to a goal.",
        "properties": {
          "access_level": {
            "description": "\"Describes the membership access level for the goal. This is preferred over role.\"",
            "enum": [
              "viewer",
              "commenter",
              "editor",
              "admin"
            ],
            "example": "editor",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "goal": {
            "allOf": [
              {
                "$ref": "#/components/schemas/GoalCompact"
              },
              {
                "deprecated": true,
                "description": "*Deprecated: new integrations should prefer the `parent` field.* A *Goal* is an object in the goal-tracking system that helps your organization drive measurable results.",
                "readOnly": true,
                "type": "object"
              }
            ]
          },
          "member": {
            "$ref": "#/components/schemas/MemberCompact"
          },
          "parent": {
            "allOf": [
              {
                "$ref": "#/components/schemas/GoalCompact"
              },
              {
                "readOnly": true,
                "type": "object"
              }
            ]
          },
          "resource_subtype": {
            "description": "The type of membership.",
            "example": "goal_membership",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "membership",
            "type": "string"
          },
          "role": {
            "deprecated": true,
            "description": "*Deprecated: Describes if the member is a commenter or editor in goal.*",
            "enum": [
              "commenter",
              "editor"
            ],
            "example": "editor",
            "type": "string"
          }
        },
        "type": "object"
      },
      "GoalMembershipCompact": {
        "allOf": [
          {
            "$ref": "#/components/schemas/GoalMembershipBase"
          },
          {
            "properties": {
              "is_commenter": {
                "deprecated": true,
                "description": "*Deprecated: new integrations should prefer the `access_level` field.* Describes if the member is comment only in goal. This field is deprecated and will always be null.",
                "example": false,
                "readOnly": true,
                "type": "boolean"
              },
              "is_editor": {
                "deprecated": true,
                "description": "*Deprecated: new integrations should prefer the `access_level` field.* Describes if the member is editor in goal. This field is deprecated and will always be null.",
                "example": false,
                "readOnly": true,
                "type": "boolean"
              }
            },
            "type": "object"
          }
        ]
      },
      "GoalMembershipResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/GoalMembershipBase"
          },
          {
            "properties": {
              "user": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/UserCompact"
                  },
                  {
                    "deprecated": true,
                    "description": "*Deprecated: new integrations should prefer the `member` field.* A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                    "readOnly": true,
                    "type": "object"
                  }
                ]
              },
              "workspace": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/WorkspaceCompact"
                  },
                  {
                    "deprecated": true,
                    "description": "*Deprecated:* A *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
                    "readOnly": true,
                    "type": "object"
                  }
                ]
              }
            },
            "type": "object"
          }
        ]
      },
      "GoalMetricBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "currency_code": {
            "description": "ISO 4217 currency code to format this custom field. This will be null if the `unit` is not `currency`.",
            "example": "EUR",
            "nullable": true,
            "type": "string"
          },
          "current_display_value": {
            "description": "This string is the current value of a goal metric of type string.",
            "example": "8.12",
            "readOnly": true,
            "type": "string"
          },
          "current_number_value": {
            "description": "This number is the current value of a goal metric of type number.",
            "example": 8.12,
            "type": "number"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "initial_number_value": {
            "description": "This number is the start value of a goal metric of type number.",
            "example": 5.2,
            "type": "number"
          },
          "is_custom_weight": {
            "description": "*Conditional*. Only relevant if `metric.progress_source` is one of `subgoal_progress`, `project_task_completion`, `project_milestone_completion`, or `task_completion`. If true, we use the supporting object's custom weight to calculate the goal's progress. If false, we treat all supporting objects as equally weighted",
            "example": false,
            "type": "boolean"
          },
          "precision": {
            "description": "*Conditional*. Only relevant for goal metrics of type `Number`. This field dictates the number of places after the decimal to round to, i.e. 0 is integer values, 1 rounds to the nearest tenth, and so on. Must be between 0 and 6, inclusive.\nFor percentage format, this may be unintuitive, as a value of 0.25 has a precision of 0, while a value of 0.251 has a precision of 1. This is due to 0.25 being displayed as 25%.",
            "example": 2,
            "type": "integer"
          },
          "progress_source": {
            "description": "This field defines how the progress value of a goal metric is being calculated. A goal's progress can be provided manually by the user, calculated automatically from contributing subgoals, projects, or tasks, or managed by an integration with an external data source, such as Salesforce.",
            "enum": [
              "manual",
              "subgoal_progress",
              "project_task_completion",
              "project_milestone_completion",
              "task_completion",
              "external"
            ],
            "example": "manual",
            "type": "string"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "enum": [
              "number"
            ],
            "example": "number",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "target_number_value": {
            "description": "This number is the end value of a goal metric of type number. This number cannot equal `initial_number_value`.",
            "example": 10.2,
            "type": "number"
          },
          "unit": {
            "description": "A supported unit of measure for the goal metric, or none.",
            "enum": [
              "none",
              "currency",
              "percentage"
            ],
            "type": "string"
          }
        },
        "type": "object"
      },
      "GoalMetricCurrentValueRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "current_number_value": {
            "description": "*Conditional*. This number is the current value of a goal metric of type number.",
            "example": 8.12,
            "type": "number"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "GoalMetricRequest": {
        "$ref": "#/components/schemas/GoalMetricBase"
      },
      "GoalRelationshipBase": {
        "allOf": [
          {
            "$ref": "#/components/schemas/GoalRelationshipCompact"
          },
          {
            "properties": {
              "supported_goal": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/GoalCompact"
                  },
                  {
                    "description": "The goal that the supporting resource supports.",
                    "readOnly": true,
                    "type": "object"
                  }
                ]
              }
            },
            "type": "object"
          }
        ]
      },
      "GoalRelationshipCompact": {
        "description": "A *goal relationship* is an object representing the relationship between a goal and another goal, a project, a task, or a portfolio.",
        "properties": {
          "contribution_weight": {
            "description": "The weight that the supporting resource's progress contributes to the supported goal's progress. This can be 0, 1, or any value in between.",
            "example": 1,
            "type": "number"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "enum": [
              "subgoal",
              "supporting_work"
            ],
            "example": "subgoal",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "goal_relationship",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "supporting_resource": {
            "allOf": [
              {
                "$ref": "#/components/schemas/ProjectCompact"
              },
              {
                "description": "The supporting resource that supports the goal. This can be either a project, task, portfolio, or goal.",
                "readOnly": true,
                "type": "object"
              }
            ]
          }
        },
        "type": "object"
      },
      "GoalRelationshipRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/GoalRelationshipBase"
          },
          {
            "type": "object"
          }
        ]
      },
      "GoalRelationshipResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/GoalRelationshipBase"
          },
          {
            "type": "object"
          }
        ]
      },
      "GoalRemoveSubgoalRequest": {
        "properties": {
          "subgoal": {
            "description": "The goal gid to remove as subgoal from the parent goal",
            "example": "1331",
            "type": "string"
          }
        },
        "required": [
          "subgoal"
        ],
        "type": "object"
      },
      "GoalRemoveSupportingRelationshipRequest": {
        "properties": {
          "supporting_resource": {
            "description": "The gid of the supporting resource to remove from the parent goal. Must be the gid of a goal, project, task, or portfolio.",
            "example": "12345",
            "type": "string"
          }
        },
        "required": [
          "supporting_resource"
        ],
        "type": "object"
      },
      "GoalRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/GoalRequestBase"
          },
          {
            "properties": {
              "followers": {
                "example": [
                  "12345"
                ],
                "items": {
                  "description": "The `gid` of a user.",
                  "type": "string"
                },
                "type": "array"
              }
            },
            "type": "object"
          }
        ]
      },
      "GoalRequestBase": {
        "allOf": [
          {
            "$ref": "#/components/schemas/GoalBase"
          },
          {
            "properties": {
              "owner": {
                "description": "The `gid` of a user.",
                "example": "12345",
                "nullable": true,
                "type": "string"
              },
              "team": {
                "description": "*Conditional*. This property is only present when the `workspace` provided is an organization.",
                "example": "12345",
                "nullable": true,
                "type": "string"
              },
              "time_period": {
                "description": "The `gid` of a time period.",
                "example": "12345",
                "nullable": true,
                "type": "string"
              },
              "workspace": {
                "description": "The `gid` of a workspace.",
                "example": "12345",
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "GoalResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/GoalBase"
          },
          {
            "properties": {
              "current_status_update": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/StatusUpdateCompact"
                  },
                  {
                    "description": "The latest `status_update` posted to this goal."
                  }
                ],
                "nullable": true
              },
              "custom_field_settings": {
                "description": "Array of custom field definitions that are enabled for the goal. These represent which custom fields are available to be used on items within the goal, but do not include any values.",
                "items": {
                  "$ref": "#/components/schemas/CustomFieldSettingResponse"
                },
                "type": "array"
              },
              "custom_fields": {
                "description": "Array of custom field values applied directly to the goal itself. These represent the values set on the goal, not the fields available for items in the goal.",
                "items": {
                  "$ref": "#/components/schemas/CustomFieldCompact"
                },
                "type": "array"
              },
              "default_access_level": {
                "description": "The default access level when inviting new members to the goal",
                "enum": [
                  "admin",
                  "editor",
                  "commenter",
                  "viewer"
                ],
                "example": "editor",
                "type": "string"
              },
              "followers": {
                "description": "Array of users who are members of this goal.",
                "items": {
                  "$ref": "#/components/schemas/UserCompact"
                },
                "type": "array"
              },
              "likes": {
                "description": "Array of likes for users who have liked this goal.",
                "items": {
                  "$ref": "#/components/schemas/Like"
                },
                "readOnly": true,
                "type": "array"
              },
              "metric": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/GoalMetricBase"
                  },
                  {
                    "properties": {
                      "can_manage": {
                        "description": "*Conditional*. Only relevant for `progress_source` of type `external`. This boolean indicates whether the requester has the ability to update the current value of this metric. This returns `true` if the external metric was created by the requester, `false` otherwise.",
                        "example": true,
                        "readOnly": true,
                        "type": "boolean"
                      }
                    },
                    "type": "object"
                  }
                ],
                "nullable": true
              },
              "num_likes": {
                "description": "The number of users who have liked this goal.",
                "example": 5,
                "readOnly": true,
                "type": "integer"
              },
              "owner": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/UserCompact"
                  },
                  {
                    "type": "object"
                  }
                ],
                "nullable": true
              },
              "privacy_setting": {
                "description": "The privacy setting of the goal.",
                "enum": [
                  "public_to_workspace",
                  "members_only"
                ],
                "example": "public_to_workspace",
                "type": "string"
              },
              "status": {
                "description": "The current status of this goal. When the goal is open, its status can be `green`, `yellow`, and `red` to reflect \"On Track\", \"At Risk\", and \"Off Track\", respectively. When the goal is closed, the value can be `missed`, `achieved`, `partial`, or `dropped`.\n*Note* you can only write to this property if `metric` is set.",
                "example": "green",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "team": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TeamCompact"
                  },
                  {
                    "description": "*Conditional*. This property is only present when the `workspace` provided is an organization.",
                    "type": "object"
                  }
                ],
                "nullable": true
              },
              "time_period": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TimePeriodCompact"
                  },
                  {
                    "type": "object"
                  }
                ],
                "nullable": true
              },
              "workspace": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/WorkspaceCompact"
                  },
                  {
                    "type": "object"
                  }
                ]
              }
            },
            "type": "object"
          }
        ]
      },
      "GoalUpdateRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/GoalRequestBase"
          },
          {
            "properties": {
              "custom_fields": {
                "additionalProperties": {
                  "description": "\"{custom_field_gid}\" => Value (can be text, enum GID, a number, etc.). For date, use format \"YYYY-MM-DD\" (e.g., 2019-09-15). For date-time, use ISO 8601 date string in UTC (e.g., 2019-09-15T02:06:58.147Z).",
                  "type": "string"
                },
                "description": "An object where each key is the GID of a custom field and its corresponding value is either an enum GID, string, number, or object (depending on the custom field type). See the [custom fields guide](/docs/custom-fields-guide) for details on creating and updating custom field values.",
                "example": {
                  "4578152156": "Not Started",
                  "5678904321": "On Hold"
                },
                "type": "object"
              },
              "html_custom_fields": {
                "additionalProperties": {
                  "description": "\"{custom_field_gid}\" => HTML string (e.g., \"<body>Text content</body>\")",
                  "type": "string"
                },
                "description": "An object where each key is the GID of a text custom field and the corresponding value is a rich text HTML string. Only text-type custom fields support this parameter. Values must be wrapped in <body></body> tags. See the [custom fields guide](/docs/custom-fields-guide) and [rich text](/docs/rich-text) for details on supported formatting.",
                "example": {
                  "4578152156": "<body><code>Code block</code></body>",
                  "5678904321": "<body><strong>Bold text</strong></body>"
                },
                "type": "object"
              },
              "status": {
                "description": "The current status of this goal. When the goal is open, its status can be `green`, `yellow`, and `red` to reflect \"On Track\", \"At Risk\", and \"Off Track\", respectively. When the goal is closed, the value can be `missed`, `achieved`, `partial`, or `dropped`.\n*Note* you can only write to this property if `metric` is set.",
                "example": "green",
                "nullable": true,
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "GraphExportCompact": {
        "description": "A *graph_export* object represents a request to export the data starting from a parent object",
        "properties": {
          "completed_at": {
            "description": "The time at which this resource was completed.",
            "example": "2012-02-22T03:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "download_url": {
            "description": "Download this URL to retrieve the full export\nin JSON format. It will be compressed in a gzip (.gz) container.\n\n*Note: May be null if the export is still in progress or\nfailed.  If present, this URL may only be valid for 1 hour from\nthe time of retrieval. You should avoid persisting this URL\nsomewhere and rather refresh on demand to ensure you do not keep\nstale URLs.*",
            "example": "https://asana-export-us-east-1.s3.us-east-1.amazonaws.com/2563645399633793/domain_export/7588024658887731/download/ domain_export_2563645399633793_7588024658887731_2023018-201726.json.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256& X-Amz-Content-Sha256=xxxxxxxx&X-Amz-Date=xxxxxxxx&X-Amz-Expires=300&X-Amz-Security-Token=xxxxxxxx& X-Amz-Signature=xxxxxxxx&X-Amz-SignedHeaders=host&x-id=GetObject#_=_",
            "format": "uri",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "graph_export",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "GraphExportRequest": {
        "description": "A *graph_export* request starts a job to export data starting from a parent object.",
        "properties": {
          "parent": {
            "description": "Globally unique ID of the parent object: goal, project, portfolio, or team.",
            "example": "181636",
            "type": "string"
          }
        },
        "type": "object"
      },
      "GraphExportResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "new_graph_export": {
            "$ref": "#/components/schemas/GraphExportCompact"
          },
          "resource_subtype": {
            "description": "A *graph_export* object represents a request to export the data starting from a parent object",
            "example": "graph_export_request",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "job",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "status": {
            "description": "The current status of this job.",
            "enum": [
              "not_started",
              "in_progress",
              "succeeded",
              "failed"
            ],
            "example": "succeeded",
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "JobBase": {
        "$ref": "#/components/schemas/JobCompact"
      },
      "JobCompact": {
        "description": "A *job* is an object representing a process that handles asynchronous work.",
        "properties": {
          "dates_rollup_progress": {
            "description": "Progress of a subtask date rollup job. Only present on project rollup jobs; the object is empty until the job discovers tasks to reconcile.",
            "properties": {
              "total_tasks": {
                "description": "The total number of tasks discovered for reconciliation so far. This value may increase while the job is running and is final when the job completes.",
                "example": 40,
                "minimum": 0,
                "readOnly": true,
                "type": "integer"
              },
              "updated_tasks": {
                "description": "The number of tasks whose dates have been reconciled so far.",
                "example": 12,
                "minimum": 0,
                "readOnly": true,
                "type": "integer"
              }
            },
            "readOnly": true,
            "type": "object"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "new_graph_export": {
            "$ref": "#/components/schemas/GraphExportCompact"
          },
          "new_portfolio": {
            "$ref": "#/components/schemas/PortfolioCompact"
          },
          "new_project": {
            "$ref": "#/components/schemas/ProjectCompact"
          },
          "new_project_template": {
            "$ref": "#/components/schemas/ProjectTemplateCompact"
          },
          "new_resource_export": {
            "$ref": "#/components/schemas/ResourceExportCompact"
          },
          "new_task": {
            "allOf": [
              {
                "$ref": "#/components/schemas/TaskCompact"
              },
              {
                "type": "object"
              }
            ],
            "nullable": true
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "example": "duplicate_task",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "job",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "status": {
            "description": "The current status of this job.",
            "enum": [
              "not_started",
              "in_progress",
              "succeeded",
              "failed"
            ],
            "example": "in_progress",
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "JobResponse": {
        "$ref": "#/components/schemas/JobBase"
      },
      "Like": {
        "description": "An object to represent a user's like.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the object, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string"
          },
          "user": {
            "$ref": "#/components/schemas/UserCompact"
          }
        },
        "type": "object"
      },
      "MarkNotificationsRequest": {
        "properties": {
          "notification_gids": {
            "description": "The notifications to update. Between 1 and 50 GIDs may be supplied, and duplicate GIDs are ignored.",
            "example": [
              "1234567890",
              "1234567891"
            ],
            "items": {
              "description": "The `gid` of a notification.",
              "type": "string"
            },
            "maxItems": 50,
            "minItems": 1,
            "type": "array"
          },
          "workspace": {
            "description": "GID of the workspace used to route the request.",
            "example": "31326",
            "type": "string"
          }
        },
        "required": [
          "workspace",
          "notification_gids"
        ],
        "type": "object"
      },
      "MarkNotificationsResponse": {
        "properties": {
          "failed_gids": {
            "description": "The GIDs from notification_gids that could not be updated, for example because the notification does not exist, does not belong to the caller, or has been deleted. GIDs not listed here were updated successfully. Empty when every GID succeeded.",
            "example": [
              "1234567891"
            ],
            "items": {
              "description": "The `gid` of a notification that failed to update.",
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "MemberCompact": {
        "description": "A *member* object represents either a team or user.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the member",
            "example": "Greg Sanchez",
            "type": "string"
          },
          "resource_type": {
            "description": "The type of the member (team or user)",
            "example": "user",
            "type": "string"
          }
        },
        "type": "object"
      },
      "MembershipCompact": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/GoalMembershipCompact"
          },
          {
            "$ref": "#/components/schemas/ProjectMembershipCompactResponse"
          },
          {
            "$ref": "#/components/schemas/PortfolioMembershipCompactResponse"
          },
          {
            "$ref": "#/components/schemas/CustomFieldMembershipCompact"
          },
          {
            "$ref": "#/components/schemas/CustomTypeMembershipCompact"
          },
          {
            "$ref": "#/components/schemas/TableMembershipCompact"
          },
          {
            "$ref": "#/components/schemas/RecordMembershipCompact"
          }
        ]
      },
      "MembershipRequest": {
        "properties": {
          "access_level": {
            "description": "Sets the access level for the member. Goals can have access levels `viewer`, `commenter`, `editor` or `admin`. Projects can have access levels `admin`, `editor` or `commenter`. Portfolios can have access levels `admin`, `editor` or `viewer`. Custom Fields can have access levels `admin`, `editor` or `user`. Tables accept `admin`, `editor`, or `viewer` on creation. Records accept `admin`, `editor`, `commenter`, or `viewer`.",
            "example": "editor",
            "type": "string"
          }
        },
        "type": "object"
      },
      "MembershipResponse": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/GoalMembershipResponse"
          },
          {
            "$ref": "#/components/schemas/ProjectMembershipCompactResponse"
          },
          {
            "$ref": "#/components/schemas/PortfolioMembershipResponse"
          },
          {
            "$ref": "#/components/schemas/CustomFieldMembershipResponse"
          },
          {
            "$ref": "#/components/schemas/CustomTypeMembershipResponse"
          },
          {
            "$ref": "#/components/schemas/TableMembershipResponse"
          },
          {
            "$ref": "#/components/schemas/RecordMembershipResponse"
          }
        ]
      },
      "MembershipUpdateRequest": {
        "properties": {
          "access_level": {
            "description": "The role given to the member. Goals can have access levels `editor` or `commenter`. Projects can have access levels `admin`, `editor` or `commenter`. Portfolios can have access levels `admin`, `editor` or `viewer`.",
            "example": "editor",
            "type": "string"
          }
        },
        "type": "object"
      },
      "ModifyDependenciesRequest": {
        "example": {
          "dependencies": [
            "133713",
            "184253"
          ]
        },
        "properties": {
          "dependencies": {
            "description": "An array of task gids that a task depends on.",
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "ModifyDependentsRequest": {
        "description": "A set of dependent tasks.",
        "example": {
          "dependents": [
            "133713",
            "184253"
          ]
        },
        "properties": {
          "dependents": {
            "description": "An array of task gids that are dependents of the given task.",
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "NextPage": {
        "description": "*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.",
        "nullable": true,
        "properties": {
          "offset": {
            "description": "Pagination offset for the request.",
            "example": "eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9",
            "readOnly": true,
            "type": "string"
          },
          "path": {
            "description": "A relative path containing the query parameters to fetch for next_page",
            "example": "/tasks/12345/attachments?limit=2&offset=eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9",
            "readOnly": true,
            "type": "string"
          },
          "uri": {
            "description": "A full uri containing the query parameters to fetch for next_page",
            "example": "https://app.asana.com/api/1.0/tasks/12345/attachments?limit=2&offset=eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9",
            "format": "uri",
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "NotificationBase": {
        "allOf": [
          {
            "$ref": "#/components/schemas/NotificationCompact"
          }
        ]
      },
      "NotificationCompact": {
        "description": "A *notification* is a recipient-specific record generated for the authenticated user when a story they should be notified about occurs in Asana. Multiple notifications can refer to the same underlying story, one per eligible recipient.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "notification",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "required": [
          "gid",
          "resource_type"
        ],
        "type": "object"
      },
      "NotificationResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/NotificationBase"
          },
          {
            "properties": {
              "created_at": {
                "description": "The time at which the notification was created.",
                "example": "2026-08-20T18:42:31.123Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "created_by": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/AsanaNamedResource"
                  },
                  {
                    "description": "The computed actor responsible for the underlying activity, or `null` when no actor is available.",
                    "readOnly": true,
                    "type": "object"
                  }
                ],
                "nullable": true
              },
              "is_read": {
                "description": "Whether the notification is effectively read in the user's Inbox.",
                "example": false,
                "readOnly": true,
                "type": "boolean"
              },
              "priority_classification": {
                "description": "The notification's Priority classification.",
                "enum": [
                  "unclassified"
                ],
                "example": "unclassified",
                "readOnly": true,
                "type": "string"
              },
              "story": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/StoryCompact"
                  }
                ],
                "description": "The Story that produced the notification. This is `null` when the activity is not exposed through the Stories API.",
                "nullable": true,
                "readOnly": true,
                "type": "object"
              },
              "story_resource_subtype": {
                "description": "The stable public subtype of the Story that produced the notification.",
                "example": "comment_added",
                "readOnly": true,
                "type": "string"
              },
              "work_objects": {
                "description": "Work referenced by the notification. Each entry is a compact representation of the underlying Asana resource.",
                "items": {
                  "$ref": "#/components/schemas/AsanaNamedResource"
                },
                "readOnly": true,
                "type": "array"
              }
            },
            "required": [
              "priority_classification",
              "story_resource_subtype",
              "work_objects",
              "story",
              "created_by",
              "created_at",
              "is_read"
            ],
            "type": "object"
          }
        ]
      },
      "OooEntryBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "end_date": {
            "description": "The day on which the OOO entry ends.",
            "example": "2024-01-15",
            "format": "date",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "ooo_entry",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_date": {
            "description": "The day on which the OOO entry starts.",
            "example": "2024-01-01",
            "format": "date",
            "type": "string"
          }
        },
        "type": "object"
      },
      "OooEntryCreateRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/OooEntryBase"
          },
          {
            "properties": {
              "user": {
                "description": "Globally unique identifier for the user who is out of office.",
                "type": "string"
              },
              "workspace": {
                "description": "Globally unique identifier for the workspace.",
                "example": "98765",
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "OooEntryResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/OooEntryBase"
          },
          {
            "properties": {
              "created_by": {
                "$ref": "#/components/schemas/UserCompact",
                "description": "The user who created the OOO entry.",
                "type": "object"
              },
              "user": {
                "$ref": "#/components/schemas/UserCompact",
                "description": "The user who is out of office.",
                "type": "object"
              }
            },
            "type": "object"
          }
        ]
      },
      "OooEntryUpdateRequest": {
        "$ref": "#/components/schemas/OooEntryBase"
      },
      "OrganizationExportBase": {
        "$ref": "#/components/schemas/OrganizationExportCompact"
      },
      "OrganizationExportCompact": {
        "description": "An *organization_export* object represents a request to export the complete data of an Organization in JSON format.",
        "properties": {
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "download_url": {
            "description": "Download this URL to retrieve the full export of the organization\nin JSON format. It will be compressed in a gzip (.gz) container.\n\n*Note: May be null if the export is still in progress or\nfailed.  If present, this URL may only be valid for 1 hour from\nthe time of retrieval. You should avoid persisting this URL\nsomewhere and rather refresh on demand to ensure you do not keep\nstale URLs.*",
            "example": "https://asana-export-us-east-1.s3.us-east-1.amazonaws.com/2563645399633793/domain_export/7588024658887731/download/ domain_export_2563645399633793_7588024658887731_2023018-201726.json.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256& X-Amz-Content-Sha256=xxxxxxxx&X-Amz-Date=xxxxxxxx&X-Amz-Expires=300&X-Amz-Security-Token=xxxxxxxx& X-Amz-Signature=xxxxxxxx&X-Amz-SignedHeaders=host&x-id=GetObject#_=_",
            "format": "uri",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "organization": {
            "$ref": "#/components/schemas/WorkspaceCompact"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "organization_export",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "state": {
            "description": "The current state of the export.",
            "enum": [
              "pending",
              "started",
              "finished",
              "error"
            ],
            "example": "started",
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "OrganizationExportRequest": {
        "description": "An *organization_export* request starts a job to export the complete data of the given Organization.",
        "properties": {
          "organization": {
            "description": "Globally unique identifier for the workspace or organization.",
            "example": "1331",
            "type": "string"
          }
        },
        "type": "object"
      },
      "OrganizationExportResponse": {
        "$ref": "#/components/schemas/OrganizationExportBase"
      },
      "PlaceholderCompact": {
        "description": "A *placeholder* object represents a placeholder in Asana that can be used to represent a placeholder user.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The placeholder's name.",
            "example": "Greg-Placeholder Sanchez",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "user",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "PlaceholderRateCompact": {
        "allOf": [
          {
            "$ref": "#/components/schemas/RateCompact"
          },
          {
            "properties": {
              "resource": {
                "$ref": "#/components/schemas/PlaceholderCompact"
              }
            },
            "type": "object"
          }
        ]
      },
      "PortfolioAddItemRequest": {
        "properties": {
          "insert_after": {
            "description": "An id of an item in this portfolio. The new item will be added after the one specified here. `insert_before` and `insert_after` parameters cannot both be specified.",
            "example": "1331",
            "type": "string"
          },
          "insert_before": {
            "description": "An id of an item in this portfolio. The new item will be added before the one specified here. `insert_before` and `insert_after` parameters cannot both be specified.",
            "example": "1331",
            "type": "string"
          },
          "item": {
            "description": "The item to add to the portfolio.",
            "example": "1331",
            "type": "string"
          }
        },
        "required": [
          "item"
        ],
        "type": "object"
      },
      "PortfolioBase": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PortfolioCompact"
          },
          {
            "properties": {
              "archived": {
                "description": "[Opt In](/docs/inputoutput-options). True if the portfolio is archived, false if not. Archived portfolios do not show in the UI by default and may be treated differently for queries.",
                "example": false,
                "type": "boolean"
              },
              "color": {
                "description": "Color of the portfolio.",
                "enum": [
                  "dark-pink",
                  "dark-green",
                  "dark-blue",
                  "dark-red",
                  "dark-teal",
                  "dark-brown",
                  "dark-orange",
                  "dark-purple",
                  "dark-warm-gray",
                  "light-pink",
                  "light-green",
                  "light-blue",
                  "light-red",
                  "light-teal",
                  "light-brown",
                  "light-orange",
                  "light-purple",
                  "light-warm-gray"
                ],
                "example": "light-green",
                "type": "string"
              },
              "default_access_level": {
                "description": "The default access level when inviting new members to the portfolio",
                "enum": [
                  "admin",
                  "editor",
                  "viewer"
                ],
                "example": "viewer",
                "type": "string"
              },
              "due_on": {
                "description": "The day on which this portfolio is due. This takes a date with format YYYY-MM-DD.",
                "example": "2019-09-15",
                "format": "date",
                "nullable": true,
                "type": "string"
              },
              "public": {
                "description": "Defines whether the portfolio is public to its workspace members. `true` if the portfolio is public to workspace members, `false` if it's visible only to members of the portfolio. New portfolios are private by default.",
                "example": false,
                "type": "boolean"
              },
              "start_on": {
                "description": "The day on which work for this portfolio begins, or null if the portfolio has no start date. This takes a date with `YYYY-MM-DD` format. *Note: `due_on` must be present in the request when setting or unsetting the `start_on` parameter. Additionally, `start_on` and `due_on` cannot be the same date.*",
                "example": "2019-09-14",
                "format": "date",
                "nullable": true,
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "PortfolioCompact": {
        "description": "A *portfolio* gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent [project status](/reference/project-statuses) update.\nPortfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the portfolio.",
            "example": "Bug Portfolio",
            "type": "string"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "enum": [
              "default_portfolio",
              "custom"
            ],
            "example": "default_portfolio",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "portfolio",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "PortfolioDuplicateRequest": {
        "properties": {
          "include": {
            "description": "A comma-separated list of elements to include when duplicating a portfolio.\n\n**Auto-included fields (non-configurable)**\n- Custom field settings\n- Views (tabs)\n\n**Optional fields (configurable)**\n- description\n- members\n- permissions\n- templates\n- rules\n- child_projects\n- child_portfolios",
            "example": [
              "description,members,permissions,templates,rules,child_projects,child_portfolios"
            ],
            "type": "string"
          },
          "name": {
            "description": "The name of the new portfolio.",
            "example": "New Portfolio Name",
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "PortfolioItemCompact": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/ProjectCompact"
          },
          {
            "$ref": "#/components/schemas/PortfolioCompact"
          }
        ]
      },
      "PortfolioMembershipBase": {
        "$ref": "#/components/schemas/PortfolioMembershipCompact"
      },
      "PortfolioMembershipCompact": {
        "description": "This object determines if a user is a member of a portfolio.",
        "properties": {
          "access_level": {
            "description": "Whether the member has admin, editor, or viewer access to the portfolio. Portfolios do not support commenter access yet.",
            "enum": [
              "admin",
              "editor",
              "viewer"
            ],
            "example": "admin",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "$ref": "#/components/schemas/MemberCompact",
            "description": "Member can be a user or a team."
          },
          "parent": {
            "$ref": "#/components/schemas/PortfolioCompact",
            "description": "The portfolio the user is a member of."
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "portfolio_membership",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "PortfolioMembershipCompactResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PortfolioMembershipCompact"
          },
          {
            "properties": {
              "resource_subtype": {
                "description": "Type of the membership.",
                "example": "portfolio_membership",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "membership",
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "PortfolioMembershipResponse": {
        "$ref": "#/components/schemas/PortfolioMembershipBase"
      },
      "PortfolioRemoveItemRequest": {
        "properties": {
          "item": {
            "description": "The item to remove from the portfolio.",
            "example": "1331",
            "type": "string"
          }
        },
        "required": [
          "item"
        ],
        "type": "object"
      },
      "PortfolioRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PortfolioBase"
          },
          {
            "properties": {
              "custom_type": {
                "description": "*Conditional:* You can only set custom_type if portfolio `resource_subtype` is `custom`. GID or globally-unique identifier of a portfolio's custom type. The type must be valid for portfolios, and some Asana-created custom types cannot be assigned via the API; attempting either returns an error explaining which condition failed.",
                "example": "12345",
                "nullable": true,
                "readOnly": false,
                "type": "string",
                "x-env-variable": true
              },
              "workspace": {
                "description": "*Create-only*. The workspace or organization that the portfolio belongs to.",
                "example": "167589",
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "PortfolioResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PortfolioBase"
          },
          {
            "properties": {
              "created_at": {
                "description": "The time at which this resource was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "created_by": {
                "$ref": "#/components/schemas/UserCompact"
              },
              "current_status_update": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/StatusUpdateCompact"
                  },
                  {
                    "description": "The latest `status_update` posted to this portfolio."
                  }
                ],
                "nullable": true
              },
              "custom_field_settings": {
                "description": "Array of custom field definitions that are enabled for the portfolio. These represent which custom fields are available to be used on items within the portfolio, but do not include any values.",
                "items": {
                  "$ref": "#/components/schemas/CustomFieldSettingResponse"
                },
                "type": "array"
              },
              "custom_fields": {
                "description": "Array of custom field values applied directly to the portfolio itself. These represent the values set on the portfolio, not the fields available for items in the portfolio.",
                "items": {
                  "$ref": "#/components/schemas/CustomFieldCompact"
                },
                "type": "array"
              },
              "custom_type": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/CustomTypeCompact"
                  },
                  {}
                ],
                "nullable": true
              },
              "members": {
                "items": {
                  "$ref": "#/components/schemas/UserCompact"
                },
                "readOnly": true,
                "type": "array"
              },
              "owner": {
                "$ref": "#/components/schemas/UserCompact"
              },
              "permalink_url": {
                "description": "A url that points directly to the object within Asana.",
                "example": "https://app.asana.com/0/resource/123456789/list",
                "readOnly": true,
                "type": "string"
              },
              "privacy_setting": {
                "description": "The privacy setting of the portfolio. *Note: Administrators in your organization may restrict the values of `privacy_setting`.*",
                "enum": [
                  "public_to_domain",
                  "members_only"
                ],
                "example": "members_only",
                "type": "string"
              },
              "project_templates": {
                "description": "Array of project templates that are in the portfolio",
                "items": {
                  "$ref": "#/components/schemas/ProjectTemplateCompact"
                },
                "readOnly": true,
                "type": "array"
              },
              "workspace": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/WorkspaceCompact"
                  },
                  {
                    "description": "*Create-only*. The workspace or organization that the portfolio belongs to.",
                    "type": "object"
                  }
                ]
              }
            },
            "type": "object"
          }
        ]
      },
      "PortfolioUpdateRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PortfolioBase"
          },
          {
            "properties": {
              "custom_fields": {
                "additionalProperties": {
                  "description": "\"{custom_field_gid}\" => Value (can be text, enum GID, a number, etc.). For date, use format \"YYYY-MM-DD\" (e.g., 2019-09-15). For date-time, use ISO 8601 date string in UTC (e.g., 2019-09-15T02:06:58.147Z).",
                  "type": "string"
                },
                "description": "An object where each key is the GID of a custom field and its corresponding value is either an enum GID, string, number, or object (depending on the custom field type). See the [custom fields guide](/docs/custom-fields-guide) for details on creating and updating custom field values.",
                "example": {
                  "4578152156": "Not Started",
                  "5678904321": "On Hold"
                },
                "type": "object"
              },
              "custom_type": {
                "description": "*Conditional:* You can only set custom_type if portfolio `resource_subtype` is `custom`. GID or globally-unique identifier of a portfolio's custom type. The type must be valid for portfolios, and some Asana-created custom types cannot be assigned via the API; attempting either returns an error explaining which condition failed.",
                "example": "12345",
                "nullable": true,
                "readOnly": false,
                "type": "string",
                "x-env-variable": true
              },
              "html_custom_fields": {
                "additionalProperties": {
                  "description": "\"{custom_field_gid}\" => HTML string (e.g., \"<body>Text content</body>\")",
                  "type": "string"
                },
                "description": "An object where each key is the GID of a text custom field and the corresponding value is a rich text HTML string. Only text-type custom fields support this parameter. Values must be wrapped in <body></body> tags. See the [custom fields guide](/docs/custom-fields-guide) and [rich text](/docs/rich-text) for details on supported formatting.",
                "example": {
                  "4578152156": "<body><code>Code block</code></body>",
                  "5678904321": "<body><strong>Bold text</strong></body>"
                },
                "type": "object"
              }
            },
            "type": "object"
          }
        ]
      },
      "Preview": {
        "description": "A collection of rich text that will be displayed as a preview to another app.\n\nThis is read-only except for a small group of whitelisted apps.",
        "properties": {
          "fallback": {
            "description": "Some fallback text to display if unable to display the full preview.",
            "example": "Greg: Great! I like this idea.\\n\\nhttps//a_company.slack.com/archives/ABCDEFG/12345678",
            "type": "string"
          },
          "footer": {
            "description": "Text to display in the footer.",
            "example": "Mar 17, 2019 1:25 PM",
            "type": "string"
          },
          "header": {
            "description": "Text to display in the header.",
            "example": "Asana for Slack",
            "type": "string"
          },
          "header_link": {
            "description": "Where the header will link to.",
            "example": "https://asana.comn/apps/slack",
            "type": "string"
          },
          "html_text": {
            "description": "HTML formatted text for the body of the preview. See [rich text](/docs/rich-text#reading-rich-text).",
            "example": "<body>Great! I like this idea.</body>",
            "type": "string"
          },
          "text": {
            "description": "Text for the body of the preview.",
            "example": "Great! I like this idea.",
            "type": "string"
          },
          "title": {
            "description": "Text to display as the title.",
            "example": "Greg",
            "type": "string"
          },
          "title_link": {
            "description": "Where to title will link to.",
            "example": "https://asana.slack.com/archives/ABCDEFG/12345678",
            "type": "string"
          }
        },
        "readOnly": true,
        "type": "object"
      },
      "ProjectBase": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ProjectCompact"
          },
          {
            "properties": {
              "archived": {
                "description": "True if the project is archived, false if not. Archived projects do not show in the UI by default and may be treated differently for queries.",
                "example": false,
                "type": "boolean"
              },
              "color": {
                "description": "Color of the project.",
                "enum": [
                  "dark-pink",
                  "dark-green",
                  "dark-blue",
                  "dark-red",
                  "dark-teal",
                  "dark-brown",
                  "dark-orange",
                  "dark-purple",
                  "dark-warm-gray",
                  "light-pink",
                  "light-green",
                  "light-blue",
                  "light-red",
                  "light-teal",
                  "light-brown",
                  "light-orange",
                  "light-purple",
                  "light-warm-gray",
                  "none",
                  null
                ],
                "example": "light-green",
                "nullable": true,
                "type": "string"
              },
              "created_at": {
                "description": "The time at which this resource was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "current_status": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ProjectStatusResponse"
                  },
                  {
                    "description": "*Deprecated: new integrations should prefer the `current_status_update` resource.*",
                    "type": "object"
                  }
                ],
                "nullable": true
              },
              "current_status_update": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/StatusUpdateCompact"
                  },
                  {
                    "description": "The latest `status_update` posted to this project.",
                    "type": "object"
                  }
                ],
                "nullable": true
              },
              "custom_field_settings": {
                "description": "Array of custom field definitions that are enabled for the project. These represent which custom fields are available to be used on tasks within the project, but do not include any values.",
                "items": {
                  "$ref": "#/components/schemas/CustomFieldSettingResponse"
                },
                "readOnly": true,
                "type": "array"
              },
              "default_access_level": {
                "description": "The default access for users or teams who join or are added as members to the project.",
                "enum": [
                  "admin",
                  "editor",
                  "commenter",
                  "viewer"
                ],
                "example": "admin",
                "type": "string"
              },
              "default_view": {
                "description": "The default view (list, board, calendar, or timeline) of a project.",
                "enum": [
                  "list",
                  "board",
                  "calendar",
                  "timeline"
                ],
                "example": "calendar",
                "type": "string"
              },
              "due_date": {
                "description": "*Deprecated: new integrations should prefer the `due_on` field.*",
                "example": "2019-09-15",
                "format": "date",
                "nullable": true,
                "type": "string"
              },
              "due_on": {
                "description": "The day on which this project is due. This takes a date with format YYYY-MM-DD.",
                "example": "2019-09-15",
                "format": "date",
                "nullable": true,
                "type": "string"
              },
              "html_notes": {
                "description": "[Opt In](/docs/inputoutput-options). The notes of the project with formatting as HTML. See [rich text](/docs/rich-text).",
                "example": "<body>These are things we need to purchase.</body>",
                "type": "string"
              },
              "icon": {
                "description": "The icon for a project.",
                "enum": [
                  "list",
                  "board",
                  "timeline",
                  "calendar",
                  "rocket",
                  "people",
                  "graph",
                  "star",
                  "bug",
                  "light_bulb",
                  "globe",
                  "gear",
                  "notebook",
                  "computer",
                  "check",
                  "target",
                  "html",
                  "megaphone",
                  "chat_bubbles",
                  "briefcase",
                  "page_layout",
                  "mountain_flag",
                  "puzzle",
                  "presentation",
                  "line_and_symbols",
                  "speed_dial",
                  "ribbon",
                  "shoe",
                  "shopping_basket",
                  "map",
                  "ticket",
                  "coins"
                ],
                "example": "chat_bubbles",
                "nullable": true,
                "type": "string"
              },
              "members": {
                "description": "Array of users who are members of this project.",
                "items": {
                  "$ref": "#/components/schemas/UserCompact"
                },
                "readOnly": true,
                "type": "array"
              },
              "minimum_access_level_for_customization": {
                "description": "The minimum access level needed for project members to modify this project's workflow and appearance.",
                "enum": [
                  "admin",
                  "editor"
                ],
                "example": "admin",
                "type": "string"
              },
              "minimum_access_level_for_sharing": {
                "description": "The minimum access level needed for project members to share the project and manage project memberships.",
                "enum": [
                  "admin",
                  "editor"
                ],
                "example": "admin",
                "type": "string"
              },
              "modified_at": {
                "description": "The time at which this project was last modified.\n*Note: This does not currently reflect any changes in associations such as tasks or comments that may have been added or removed from the project.*",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "notes": {
                "description": "Free-form textual information associated with the project (ie., its description).",
                "example": "These are things we need to purchase.",
                "type": "string"
              },
              "privacy_setting": {
                "description": "The privacy setting of the project. *Note: Administrators in your organization may restrict the values of `privacy_setting`.* The value `private_to_team` is deprecated. Use `POST /memberships` to share a project with a team after creation.",
                "enum": [
                  "public_to_workspace",
                  "private_to_team",
                  "private"
                ],
                "example": "public_to_workspace",
                "type": "string"
              },
              "public": {
                "deprecated": true,
                "description": "*Deprecated:* new integrations use `privacy_setting` instead.",
                "example": false,
                "type": "boolean"
              },
              "start_on": {
                "description": "The day on which work for this project begins, or null if the project has no start date. This takes a date with `YYYY-MM-DD` format. *Note: `due_on` or `due_at` must be present in the request when setting or unsetting the `start_on` parameter. Additionally, `start_on` and `due_on` cannot be the same date.*",
                "example": "2019-09-14",
                "format": "date",
                "nullable": true,
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "ProjectBriefBase": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ProjectBriefCompact"
          },
          {
            "properties": {
              "html_text": {
                "description": "HTML formatted text for the project brief. See [rich text](/docs/rich-text).",
                "example": "<body>This is a <strong>project brief</strong>.</body>",
                "type": "string"
              },
              "title": {
                "description": "The title of the project brief.",
                "example": "Stuff to buy — Project Brief",
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "ProjectBriefCompact": {
        "description": "A *Project Brief* allows you to explain the what and why of the project to your team.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "project_brief",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "ProjectBriefRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ProjectBriefBase"
          },
          {
            "properties": {
              "text": {
                "description": "The plain text of the project brief. When writing to a project brief, you can specify either `html_text` (preferred) or `text`, but not both.",
                "example": "This is a project brief.",
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "ProjectBriefResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ProjectBriefBase"
          },
          {
            "properties": {
              "permalink_url": {
                "description": "A url that points directly to the object within Asana.",
                "example": "https://app.asana.com/0/11111111/22222222",
                "readOnly": true,
                "type": "string"
              },
              "project": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ProjectCompact"
                  },
                  {
                    "description": "The project with which this project brief is associated.",
                    "type": "object"
                  }
                ]
              },
              "text": {
                "description": "[Opt In](/docs/inputoutput-options). The plain text of the project brief.",
                "example": "This is a project brief.",
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "ProjectCompact": {
        "description": "A *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "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.",
            "example": "Stuff to buy",
            "type": "string"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "enum": [
              "default_project",
              "custom"
            ],
            "example": "default_project",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "project",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "ProjectDuplicateRequest": {
        "properties": {
          "include": {
            "description": "A comma-separated list of elements to include when duplicating a project.\nSome elements are automatically included and cannot be excluded,\nwhile others are **optional** and must be explicitly specified in this field.\n\n**Auto-included fields (non-configurable)**\n- Tasks\n- [Project Views](https://asana.com/features/project-management/project-views)\n(i.e., tabs in a project such as List, Board, Dashboard, etc.)\n- [Rules](https://help.asana.com/s/article/rules)\n\n*Note: The Owner of the Rules copied to the new project is the user who performs the API call.\nIf the duplication is performed using a [Service Account](/docs/authentication#/service-account),\nnote that Service Accounts cannot access the UI to modify or pause Rules.\nTo prevent unwanted automation behavior, consider pausing Rules in the source project before duplication —\ntheir active/paused state is preserved in the new project.*\n\n**Optional fields (configurable)**\n- allocations\n- forms\n- members\n- notes\n- permissions\n- task_assignee\n- task_attachments\n- task_dates\n- task_dependencies\n- task_followers\n- task_notes\n- task_projects\n- task_subtasks\n- task_tags\n- task_templates\n- task_type_default",
            "example": [
              "allocations,forms,members,notes,permissions,task_assignee,task_attachments,task_dates,task_dependencies,task_followers,task_notes,task_projects,task_subtasks,task_tags,task_templates,task_type_default"
            ],
            "pattern": "[allocations|forms|members|notes|permissions|task_assignee|task_attachments|task_dates|task_dependencies|task_followers|task_notes|task_projects|task_subtasks|task_tags|task_templates|task_type_default]",
            "type": "string"
          },
          "name": {
            "description": "The name of the new project.",
            "example": "New Project Name",
            "type": "string"
          },
          "schedule_dates": {
            "description": "A dictionary of options to auto-shift dates. `task_dates` must be included to use this option. Requires `should_skip_weekends` and either `start_on` or `due_on`, but not both.",
            "properties": {
              "due_on": {
                "description": "Sets the last due date in the duplicated project to the given date. The rest of the due dates will be offset by the same amount as the due dates in the original project.",
                "example": "2019-05-21",
                "type": "string"
              },
              "should_skip_weekends": {
                "description": "**Required**: Determines if the auto-shifted dates should skip weekends.",
                "example": true,
                "type": "boolean"
              },
              "start_on": {
                "description": "Sets the first start date in the duplicated project to the given date. The rest of the start dates will be offset by the same amount as the start dates in the original project.",
                "example": "2019-05-21",
                "type": "string"
              }
            },
            "type": "object"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "ProjectMembershipBase": {
        "$ref": "#/components/schemas/ProjectMembershipCompact"
      },
      "ProjectMembershipCompact": {
        "description": "This object describes a team or a user's membership to a project including their level of access (Admin, Editor, Commenter, or Viewer).",
        "properties": {
          "access_level": {
            "description": "Whether the member has admin, editor, commenter, or viewer access to the project.",
            "enum": [
              "admin",
              "editor",
              "commenter",
              "viewer"
            ],
            "example": "admin",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "$ref": "#/components/schemas/MemberCompact",
            "description": "Member can be a user or a team."
          },
          "parent": {
            "$ref": "#/components/schemas/ProjectCompact",
            "description": "[Opt In](/docs/inputoutput-options). The project the user is a member of."
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "project_membership",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "ProjectMembershipCompactResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ProjectMembershipCompact"
          },
          {
            "properties": {
              "resource_subtype": {
                "description": "Type of the membership.",
                "example": "project_membership",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "membership",
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "ProjectMembershipNormalResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ProjectMembershipBase"
          },
          {
            "properties": {
              "project": {
                "$ref": "#/components/schemas/ProjectCompact",
                "description": "[Opt In](/docs/inputoutput-options). The project the user is a member of."
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "project_membership",
                "type": "string"
              },
              "user": {
                "$ref": "#/components/schemas/UserCompact"
              },
              "write_access": {
                "description": "Whether the member has full access or comment-only access to the project.",
                "enum": [
                  "full_write",
                  "comment_only"
                ],
                "example": "full_write",
                "readOnly": true,
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "ProjectPortfolioSettingCompact": {
        "description": "A project portfolio setting represents the relationship between a project and a portfolio, including configuration such as access control inheritance.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "is_access_control_inherited": {
            "description": "When true, the portfolio members gain access to the project.",
            "example": true,
            "type": "boolean"
          },
          "portfolio": {
            "allOf": [
              {
                "$ref": "#/components/schemas/PortfolioCompact"
              },
              {
                "type": "object"
              }
            ],
            "description": "The portfolio associated with this setting."
          },
          "project": {
            "allOf": [
              {
                "$ref": "#/components/schemas/ProjectCompact"
              },
              {
                "type": "object"
              }
            ],
            "description": "The project associated with this setting."
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "project_portfolio_setting",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "ProjectPortfolioSettingResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ProjectPortfolioSettingCompact"
          },
          {
            "properties": {
              "created_at": {
                "description": "The time at which this project portfolio setting was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "ProjectPortfolioSettingUpdateRequest": {
        "properties": {
          "is_access_control_inherited": {
            "description": "When true, the portfolio members gain access to the project.",
            "example": true,
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "ProjectRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ProjectBase"
          },
          {
            "properties": {
              "custom_fields": {
                "additionalProperties": {
                  "description": "\"{custom_field_gid}\" => Value (can be text, a number, etc.). For date, use format \"YYYY-MM-DD\" (e.g., 2019-09-15). For date-time, use ISO 8601 date string in UTC (e.g., 2019-09-15T02:06:58.147Z).",
                  "type": "string"
                },
                "description": "An object where each key is the GID of a custom field and its corresponding value is either an enum GID, string, number, or object (depending on the custom field type). See the [custom fields guide](/docs/custom-fields-guide) for details on creating and updating custom field values.",
                "example": {
                  "4578152156": "Not Started",
                  "5678904321": "On Hold"
                },
                "type": "object"
              },
              "custom_type": {
                "description": "*Conditional:* You can only set custom_type if project `resource_subtype` is `custom`. GID or globally-unique identifier of a project's custom type. The type must be valid for projects, and some Asana-created custom types cannot be assigned via the API; attempting either returns an error explaining which condition failed.",
                "example": "12345",
                "nullable": true,
                "readOnly": false,
                "type": "string",
                "x-env-variable": true
              },
              "followers": {
                "description": "*Create-only*. Comma separated string of users. Followers are a subset of members who have opted in to receive \"tasks added\" notifications for a project.",
                "example": "12345,23456",
                "type": "string"
              },
              "html_custom_fields": {
                "additionalProperties": {
                  "description": "\"{custom_field_gid}\" => HTML string (e.g., \"<body>Text content</body>\")",
                  "type": "string"
                },
                "description": "An object where each key is the GID of a text custom field and the corresponding value is a rich text HTML string. Only text-type custom fields support this parameter. Values must be wrapped in <body></body> tags. See the [custom fields guide](/docs/custom-fields-guide) and [rich text](/docs/rich-text) for details on supported formatting.",
                "example": {
                  "4578152156": "<body><code>Code block</code></body>",
                  "5678904321": "<body><strong>Bold text</strong></body>"
                },
                "type": "object"
              },
              "owner": {
                "description": "The current owner of the project, may be null.",
                "example": "12345",
                "nullable": true,
                "type": "string"
              },
              "team": {
                "deprecated": true,
                "description": "*Deprecated:* The team to share this project with is deprecated. Use `POST /memberships` with `{ parent: project, member: team }` to share a project with a team after creation.",
                "example": "12345",
                "type": "string"
              },
              "workspace": {
                "description": "The `gid` of a workspace.",
                "example": "12345",
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "ProjectResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ProjectBase"
          },
          {
            "properties": {
              "completed": {
                "description": "True if the project is currently marked complete, false if not.",
                "example": false,
                "readOnly": true,
                "type": "boolean"
              },
              "completed_at": {
                "description": "The time at which this project was completed, or null if the project is not completed.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "completed_by": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/UserCompact"
                  },
                  {
                    "description": "The user that marked this project complete, or null if the project is not completed.",
                    "readOnly": true
                  }
                ],
                "nullable": true
              },
              "created_from_template": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ProjectTemplateCompact"
                  },
                  {
                    "description": "[Opt In](/docs/inputoutput-options). The project template from which this project was created. If the project was not created from a template, this field will be null.",
                    "type": "object"
                  }
                ],
                "nullable": true
              },
              "custom_fields": {
                "description": "Array of custom field values applied directly to the project itself. These represent the values set on the project, not the fields available for tasks in the project.",
                "items": {
                  "$ref": "#/components/schemas/CustomFieldCompact"
                },
                "readOnly": true,
                "type": "array"
              },
              "custom_type": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/CustomTypeCompact"
                  },
                  {}
                ],
                "nullable": true
              },
              "followers": {
                "description": "Array of users following this project. Followers are a subset of members who have opted in to receive \"tasks added\" notifications for a project.",
                "items": {
                  "$ref": "#/components/schemas/UserCompact"
                },
                "readOnly": true,
                "type": "array"
              },
              "owner": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/UserCompact"
                  },
                  {
                    "type": "object"
                  }
                ],
                "description": "The current owner of the project, may be null.",
                "nullable": true
              },
              "permalink_url": {
                "description": "A url that points directly to the object within Asana.",
                "example": "https://app.asana.com/1/12345/project/123456789",
                "readOnly": true,
                "type": "string"
              },
              "project_brief": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ProjectBriefCompact"
                  },
                  {
                    "description": "[Opt In](/docs/inputoutput-options). The project brief associated with this project.",
                    "type": "object"
                  }
                ],
                "nullable": true
              },
              "team": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TeamCompact"
                  },
                  {
                    "description": "The team that this project is shared with.",
                    "type": "object"
                  }
                ]
              },
              "workspace": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/WorkspaceCompact"
                  },
                  {
                    "description": "*Create-only*. The workspace or organization this project is associated with. Once created, projects cannot be moved to a different workspace. This attribute can only be specified at creation time. If the workspace for your project is an organization, you must also supply a `team` in the request body.",
                    "readOnly": true,
                    "type": "object"
                  }
                ]
              }
            },
            "type": "object"
          }
        ]
      },
      "ProjectSaveAsTemplateRequest": {
        "properties": {
          "name": {
            "description": "The name of the new project template.",
            "example": "New Project Template",
            "type": "string"
          },
          "public": {
            "description": "Sets the project template to public to its team.",
            "example": true,
            "type": "boolean"
          },
          "team": {
            "description": "Sets the team of the new project template. If the project exists in an organization, specify team and not workspace.",
            "example": "12345",
            "type": "string"
          },
          "workspace": {
            "description": "Sets the workspace of the new project template. Only specify workspace if the project exists in a workspace.",
            "example": "12345",
            "type": "string"
          }
        },
        "required": [
          "name",
          "public"
        ],
        "type": "object"
      },
      "ProjectSectionInsertRequest": {
        "properties": {
          "after_section": {
            "description": "Insert the given section immediately after the section specified by this parameter.",
            "example": "987654",
            "type": "string"
          },
          "before_section": {
            "description": "Insert the given section immediately before the section specified by this parameter.",
            "example": "86420",
            "type": "string"
          },
          "section": {
            "description": "The section to reorder.",
            "example": "321654",
            "type": "string"
          }
        },
        "required": [
          "section"
        ],
        "type": "object"
      },
      "ProjectStatusBase": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ProjectStatusCompact"
          },
          {
            "properties": {
              "color": {
                "description": "The color associated with the status update.",
                "enum": [
                  "green",
                  "yellow",
                  "red",
                  "blue",
                  "complete"
                ],
                "type": "string"
              },
              "html_text": {
                "description": "[Opt In](/docs/inputoutput-options). The text content of the status update with formatting as HTML. See [rich text](/docs/rich-text).",
                "example": "<body>The project <strong>is</strong> moving forward according to plan...</body>",
                "type": "string"
              },
              "text": {
                "description": "The text content of the status update.",
                "example": "The project is moving forward according to plan...",
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "ProjectStatusCompact": {
        "description": "*Deprecated: new integrations should prefer the `status_update` resource.*\nA *project status* is an update on the progress of a particular project, and is sent out to all project followers when created. These updates include both text describing the update and a color code intended to represent the overall state of the project: \"green\" for projects that are on track, \"yellow\" for projects at risk, and \"red\" for projects that are behind.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "project_status",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "title": {
            "description": "The title of the project status update.",
            "example": "Status Update - Jun 15",
            "type": "string"
          }
        },
        "type": "object"
      },
      "ProjectStatusRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ProjectStatusBase"
          },
          {
            "required": [
              "color"
            ],
            "type": "object"
          }
        ]
      },
      "ProjectStatusResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ProjectStatusBase"
          },
          {
            "properties": {
              "author": {
                "$ref": "#/components/schemas/UserCompact"
              },
              "created_at": {
                "description": "The time at which this resource was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "created_by": {
                "$ref": "#/components/schemas/UserCompact"
              },
              "modified_at": {
                "description": "The time at which this project status was last modified.\n*Note: This does not currently reflect any changes in associations such as comments that may have been added or removed from the project status.*",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "ProjectTemplateBase": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ProjectTemplateCompact"
          },
          {
            "properties": {
              "color": {
                "description": "Color of the project template.",
                "enum": [
                  "dark-pink",
                  "dark-green",
                  "dark-blue",
                  "dark-red",
                  "dark-teal",
                  "dark-brown",
                  "dark-orange",
                  "dark-purple",
                  "dark-warm-gray",
                  "light-pink",
                  "light-green",
                  "light-blue",
                  "light-red",
                  "light-teal",
                  "light-brown",
                  "light-orange",
                  "light-purple",
                  "light-warm-gray",
                  null
                ],
                "example": "light-green",
                "nullable": true,
                "type": "string"
              },
              "description": {
                "description": "Free-form textual information associated with the project template",
                "example": "These are things we need to pack for a trip.",
                "type": "string"
              },
              "html_description": {
                "description": "The description of the project template with formatting as HTML. See [rich text](/docs/rich-text#reading-rich-text).",
                "example": "<body>These are things we need to pack for a trip.</body>",
                "type": "string"
              },
              "owner": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/UserCompact"
                  },
                  {
                    "type": "object"
                  }
                ],
                "description": "The current owner of the project template, may be null.",
                "nullable": true
              },
              "public": {
                "description": "True if the project template is public to its team.",
                "example": false,
                "type": "boolean"
              },
              "requested_dates": {
                "description": "Array of date variables in this project template. Calendar dates must be provided for these variables when instantiating a project.",
                "items": {
                  "$ref": "#/components/schemas/DateVariableCompact"
                },
                "readOnly": true,
                "type": "array"
              },
              "requested_roles": {
                "description": "Array of template roles in this project template. User Ids can be provided for these variables when instantiating a project to assign template tasks to the user.",
                "items": {
                  "$ref": "#/components/schemas/TemplateRole"
                },
                "type": "array"
              },
              "team": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TeamCompact"
                  }
                ]
              }
            },
            "type": "object"
          }
        ]
      },
      "ProjectTemplateCompact": {
        "description": "A *project template* is an object that allows new projects to be created with a predefined setup, which may include tasks, sections, Rules, etc. It simplifies the process of running a workflow that involves a similar set of work every time.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "Name of the project template.",
            "example": "Packing list",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "project_template",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "ProjectTemplateInstantiateProjectRequest": {
        "properties": {
          "is_strict": {
            "description": "*Optional*. If set to `true`, the endpoint returns an \"Unprocessable Entity\" error if you fail to provide a calendar date value for any date variable. If set to `false`, a default date is used for each unfulfilled date variable (e.g., the current date is used as the Start Date of a project).",
            "example": true,
            "type": "boolean"
          },
          "name": {
            "description": "The name of the new project.",
            "example": "New Project Name",
            "type": "string"
          },
          "privacy_setting": {
            "description": "The privacy setting of the project. *Note: Administrators in your organization may restrict the values of `privacy_setting`.* The value `private_to_team` is deprecated. Use `POST /memberships` to share a project with a team after creation.",
            "enum": [
              "public_to_workspace",
              "private_to_team",
              "private"
            ],
            "example": "public_to_workspace",
            "type": "string"
          },
          "public": {
            "deprecated": true,
            "description": "*Deprecated:* new integrations use `privacy_setting` instead.",
            "example": true,
            "type": "boolean"
          },
          "requested_dates": {
            "description": "*Conditional*. Array of mappings of date variables to calendar dates. This property is required in the instantiation request if the project template includes dates (e.g., a start date on a task).",
            "items": {
              "$ref": "#/components/schemas/DateVariableRequest"
            },
            "type": "array"
          },
          "requested_roles": {
            "description": "Array of mappings of template roles to users.",
            "items": {
              "$ref": "#/components/schemas/RequestedRoleRequest"
            },
            "type": "array"
          },
          "team": {
            "description": "*Optional*. Sets the team of the new project. If the project template exists in an _organization_, you may specify a value for `team`. If no value is provided then it defaults to the same team as the project template.",
            "example": "12345",
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "ProjectTemplateResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ProjectTemplateBase"
          }
        ]
      },
      "ProjectUpdateRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ProjectBase"
          },
          {
            "properties": {
              "custom_fields": {
                "additionalProperties": {
                  "description": "\"{custom_field_gid}\" => Value (can be text, a number, etc.). For date, use format \"YYYY-MM-DD\" (e.g., 2019-09-15). For date-time, use ISO 8601 date string in UTC (e.g., 2019-09-15T02:06:58.147Z).",
                  "type": "string"
                },
                "description": "An object where each key is the GID of a custom field and its corresponding value is either an enum GID, string, number, or object (depending on the custom field type). See the [custom fields guide](/docs/custom-fields-guide) for details on creating and updating custom field values.",
                "example": {
                  "4578152156": "Not Started",
                  "5678904321": "On Hold"
                },
                "type": "object"
              },
              "custom_type": {
                "description": "*Conditional:* You can only set custom_type if project `resource_subtype` is `custom`. GID or globally-unique identifier of a project's custom type. The type must be valid for projects, and some Asana-created custom types cannot be assigned via the API; attempting either returns an error explaining which condition failed.",
                "example": "12345",
                "nullable": true,
                "readOnly": false,
                "type": "string",
                "x-env-variable": true
              },
              "followers": {
                "description": "*Create-only*. Comma separated string of users. Followers are a subset of members who have opted in to receive \"tasks added\" notifications for a project.",
                "example": "12345,23456",
                "type": "string"
              },
              "html_custom_fields": {
                "additionalProperties": {
                  "description": "\"{custom_field_gid}\" => HTML string (e.g., \"<body>Text content</body>\")",
                  "type": "string"
                },
                "description": "An object where each key is the GID of a text custom field and the corresponding value is a rich text HTML string. Only text-type custom fields support this parameter. Values must be wrapped in <body></body> tags. See the [custom fields guide](/docs/custom-fields-guide) and [rich text](/docs/rich-text) for details on supported formatting.",
                "example": {
                  "4578152156": "<body><code>Code block</code></body>",
                  "5678904321": "<body><strong>Bold text</strong></body>"
                },
                "type": "object"
              },
              "owner": {
                "description": "The current owner of the project, may be null.",
                "example": "12345",
                "nullable": true,
                "type": "string"
              },
              "team": {
                "deprecated": true,
                "description": "*Deprecated:* Updating the team a project is shared with is deprecated. Use `POST /memberships` with `{ parent: project, member: team }` instead to manage team sharing.",
                "example": "12345",
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "RateBase": {
        "$ref": "#/components/schemas/RateCompact"
      },
      "RateCompact": {
        "description": "A *rate* is a monetary value assigned to a resource - `user` or `placeholder` - for a given `parent` object.",
        "properties": {
          "created_by": {
            "$ref": "#/components/schemas/UserCompact",
            "readOnly": true
          },
          "currency_code": {
            "description": "The currency code of the rate, set at the domain level.",
            "example": "USD",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "parent": {
            "$ref": "#/components/schemas/ProjectCompact"
          },
          "rate": {
            "description": "The monetary value of the rate.",
            "example": 100,
            "type": "number"
          },
          "resource": {
            "$ref": "#/components/schemas/UserCompact"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "rate",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "RateOrPlaceholderCompact": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/RateCompact"
          },
          {
            "$ref": "#/components/schemas/PlaceholderRateCompact"
          }
        ]
      },
      "RateRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "parent": {
            "description": "Globally unique ID of the parent object: project.",
            "example": "12345",
            "type": "string"
          },
          "rate": {
            "description": "The monetary value of the rate.",
            "example": 100,
            "type": "number"
          },
          "resource": {
            "description": "Globally unique ID of the resource object: user or placeholder.",
            "example": "12345",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "required": [
          "parent",
          "resource",
          "rate"
        ],
        "type": "object"
      },
      "RateResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/RateCompact"
          },
          {
            "type": "object"
          }
        ]
      },
      "RateUpdateRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "rate": {
            "description": "The monetary value of the rate.",
            "example": 100,
            "type": "number"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "RbacRoleBase": {
        "allOf": [
          {
            "$ref": "#/components/schemas/RbacRoleCompact"
          },
          {
            "properties": {
              "base_role_type": {
                "description": "The base role type of the role.",
                "enum": [
                  "guest",
                  "member",
                  "admin",
                  "super_admin",
                  "csm"
                ],
                "type": "string"
              },
              "creation_time": {
                "description": "The time at which this role was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "modified_at": {
                "description": "The time at which this role was last modified.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "permissions": {
                "description": "The permissions of the role.",
                "properties": {
                  "allowed_guest_invites": {
                    "description": "Controls what type of email users with this role are allowed to invite",
                    "enum": [
                      "all",
                      "none"
                    ],
                    "example": "all",
                    "type": "string"
                  },
                  "assign_roles": {
                    "description": "Controls whether users with this role can assign guest, member, and admin roles to other users",
                    "example": true,
                    "type": "boolean"
                  },
                  "create_and_edit_ai_automations": {
                    "description": "Controls whether users with this role can create and edit AI automations",
                    "example": true,
                    "type": "boolean"
                  },
                  "create_and_edit_ai_teammates": {
                    "description": "Controls whether users with this role can create and edit AI teammates",
                    "example": true,
                    "type": "boolean"
                  },
                  "create_app_authorization": {
                    "description": "Controls whether users with this role can create app authorizations",
                    "example": true,
                    "type": "boolean"
                  },
                  "create_global_custom_fields": {
                    "description": "Controls whether users with this role can create global custom fields",
                    "example": true,
                    "type": "boolean"
                  },
                  "create_goal": {
                    "description": "Controls whether users with this role can create goals",
                    "example": true,
                    "type": "boolean"
                  },
                  "create_pat_authorization": {
                    "description": "Controls whether users with this role can create PAT authorizations",
                    "example": true,
                    "type": "boolean"
                  },
                  "create_portfolio": {
                    "description": "Controls whether users with this role can create portfolios",
                    "example": true,
                    "type": "boolean"
                  },
                  "create_project": {
                    "description": "Controls whether users with this role can create projects",
                    "example": true,
                    "type": "boolean"
                  },
                  "create_read_only_link": {
                    "description": "Controls whether users with this role can create read-only links",
                    "example": true,
                    "type": "boolean"
                  },
                  "create_team": {
                    "description": "Controls whether users with this role can create teams",
                    "example": true,
                    "type": "boolean"
                  },
                  "download_mobile_attachments": {
                    "description": "Controls whether users with this role can download attachments from mobile app",
                    "example": true,
                    "type": "boolean"
                  },
                  "export_project_data": {
                    "description": "Controls whether users with this role can export project data",
                    "example": true,
                    "type": "boolean"
                  },
                  "import_data": {
                    "description": "Controls whether users with this role can import data into the domain",
                    "example": true,
                    "type": "boolean"
                  },
                  "manage_roles": {
                    "description": "Controls whether users with this role can create, edit, and delete roles",
                    "example": true,
                    "type": "boolean"
                  },
                  "proactive_ai": {
                    "description": "Controls whether users with this role can use proactive AI features",
                    "example": true,
                    "type": "boolean"
                  },
                  "share_goal_with_domain": {
                    "description": "Controls whether users with this role can create company-wide goals",
                    "example": true,
                    "type": "boolean"
                  },
                  "share_portfolios_with_org": {
                    "description": "Controls whether users with this role can create portfolios that are shared with the organization and share existing portfolios to the organization",
                    "example": true,
                    "type": "boolean"
                  },
                  "share_teams_with_org": {
                    "description": "Controls whether users with this role can share teams with the organization",
                    "example": true,
                    "type": "boolean"
                  },
                  "standard_ai": {
                    "description": "Controls whether users with this role can use standard AI features",
                    "example": true,
                    "type": "boolean"
                  },
                  "task_deletion_policy": {
                    "description": "Determines what tasks users with this role are allowed to delete",
                    "enum": [
                      "all",
                      "owned",
                      "none"
                    ],
                    "example": "all",
                    "type": "string"
                  },
                  "upload_attachments": {
                    "description": "Controls whether users with this role can upload attachments",
                    "example": true,
                    "type": "boolean"
                  },
                  "view_public_teams": {
                    "description": "Controls whether users with this role can view public teams",
                    "example": true,
                    "type": "boolean"
                  },
                  "view_shared_with_org_portfolios": {
                    "description": "Controls whether users with this role can view portfolios shared with the organization",
                    "example": true,
                    "type": "boolean"
                  },
                  "view_shared_with_org_projects": {
                    "description": "Controls whether users with this role can view projects shared with the organization",
                    "example": true,
                    "type": "boolean"
                  },
                  "view_shared_with_org_tasks": {
                    "description": "Controls whether users with this role can view tasks shared with the organization",
                    "example": true,
                    "type": "boolean"
                  }
                },
                "type": "object"
              }
            },
            "type": "object"
          }
        ]
      },
      "RbacRoleCompact": {
        "description": "A *role* represents a group of permissions that can be assigned to a user or team.",
        "properties": {
          "description": {
            "description": "The description of the role.",
            "example": "This role has exclusive access to create app and PAT tokens.",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "is_standard_role": {
            "description": "Whether the role is a standard role or a custom role. Defaults to `false`.",
            "example": false,
            "type": "boolean"
          },
          "name": {
            "description": "The name of the role.",
            "example": "Developer",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "role",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "RbacRoleRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/RbacRoleBase"
          },
          {
            "properties": {
              "base_role_type": {
                "description": "The base role type of the role.",
                "enum": [
                  "guest",
                  "member",
                  "admin"
                ],
                "type": "string"
              },
              "workspace": {
                "description": "*Create-only*. The GID of the workspace this role is associated with. Once created, roles cannot be moved to a different workspace. This attribute can only be specified at creation time.",
                "example": "12345",
                "type": "string"
              }
            },
            "required": [
              "name",
              "description",
              "base_role_type",
              "workspace"
            ],
            "type": "object"
          }
        ]
      },
      "RbacRoleResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/RbacRoleBase"
          },
          {
            "properties": {
              "workspace": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/WorkspaceCompact"
                  },
                  {
                    "description": "*Create-only*. The workspace this role is associated with. Once created, roles cannot be moved to a different workspace. This attribute can only be specified at creation time.",
                    "readOnly": true,
                    "type": "object"
                  }
                ]
              }
            },
            "type": "object"
          }
        ]
      },
      "RbacRoleUpdateRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/RbacRoleBase"
          }
        ]
      },
      "ReactionCompact": {
        "description": "An emoji reaction on an object.",
        "properties": {
          "emoji": {
            "description": "The emoji string used in the reaction.",
            "example": "👍",
            "type": "string"
          },
          "gid": {
            "description": "The ID of the reaction object.",
            "example": "12345",
            "type": "string"
          },
          "user": {
            "$ref": "#/components/schemas/UserCompact",
            "readOnly": true
          }
        },
        "type": "object"
      },
      "ReactionSummaryItemCompact": {
        "description": "A summary of an emoji reaction on an object.",
        "properties": {
          "count": {
            "description": "The number of reactions with the emoji variant on the object.",
            "example": 1,
            "type": "number"
          },
          "emoji_base": {
            "description": "The emoji base character used in the reaction.",
            "example": "👎",
            "type": "string"
          },
          "reacted": {
            "description": "Whether the current user has reacted with the emoji variant on the object.",
            "example": false,
            "type": "boolean"
          },
          "variant": {
            "description": "The full emoji string used in the reaction.",
            "example": "👎🏼",
            "type": "string"
          }
        },
        "type": "object"
      },
      "RecordItemBase": {
        "$ref": "#/components/schemas/RecordItemCompact"
      },
      "RecordItemCompact": {
        "description": "A *record* is a single row in a table. Fields on a record are backed by the table's custom field settings.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the record.",
            "example": "Q3 renewal",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "record",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "RecordItemRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/RecordItemBase"
          },
          {
            "properties": {
              "custom_fields": {
                "additionalProperties": {
                  "description": "\"{custom_field_gid}\" => Value (can be text, enum GID, a number, etc.). For date, use format \"YYYY-MM-DD\" (e.g., 2019-09-15). For date-time, use ISO 8601 date string in UTC (e.g., 2019-09-15T02:06:58.147Z).",
                  "type": "string"
                },
                "description": "An object where each key is the GID of a custom field and its corresponding value is either an enum GID, string, number, or object (depending on the custom field type). See the [custom fields guide](/docs/custom-fields-guide) for details on creating and updating custom field values. Only fields already associated with the record's table (i.e. already present in the table's custom field settings) can be written this way; unlike tasks and projects, records do not support force-writing a value for a custom field that is not yet on the table.",
                "example": {
                  "4578152156": "Not Started",
                  "5678904321": "On Hold"
                },
                "type": "object"
              },
              "default_access_level": {
                "description": "The default access level for users who join or are added as members of the record. This isn't applied when the record is private.",
                "enum": [
                  "admin",
                  "editor",
                  "commenter",
                  "viewer"
                ],
                "example": "viewer",
                "type": "string"
              },
              "table": {
                "description": "The table in which this record will be created.",
                "example": "1337",
                "type": "string"
              },
              "unique_fingerprint": {
                "description": "An optional client-provided identifier used to deduplicate record creation within a table. If a record already exists in the table with the same `unique_fingerprint`, the request fails with a `409 Conflict` error rather than creating a duplicate.",
                "example": "sfdc-opportunity-0061",
                "type": "string"
              }
            },
            "required": [
              "name",
              "table"
            ],
            "type": "object"
          }
        ]
      },
      "RecordItemResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/RecordItemBase"
          },
          {
            "properties": {
              "comment_count": {
                "description": "The number of comments on the record.",
                "example": 3,
                "readOnly": true,
                "type": "integer"
              },
              "created_at": {
                "description": "The time at which this resource was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "created_by": {
                "$ref": "#/components/schemas/UserCompact"
              },
              "custom_fields": {
                "description": "Array of custom field values applied to the record.",
                "items": {
                  "$ref": "#/components/schemas/CustomFieldResponse"
                },
                "type": "array"
              },
              "default_access_level": {
                "description": "The default access level for users who join or are added as members of the record. This isn't applied when the record is private.",
                "enum": [
                  "admin",
                  "editor",
                  "commenter",
                  "viewer"
                ],
                "example": "viewer",
                "type": "string"
              },
              "deleted_at": {
                "description": "The time at which this resource was deleted, or null if it has not been deleted.",
                "format": "date-time",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "is_in_archived_table": {
                "description": "True if the record's table is archived, false if not.",
                "example": false,
                "readOnly": true,
                "type": "boolean"
              },
              "modified_at": {
                "description": "The time at which this record was last modified.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "permalink_url": {
                "description": "A url that points directly to the object within Asana.",
                "example": "https://app.asana.com/0/resource/123",
                "readOnly": true,
                "type": "string"
              },
              "table": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TableCompact"
                  },
                  {
                    "description": "The table that this record belongs to. Omitted if you don't have access to the table, or null if the record has no associated table.",
                    "readOnly": true
                  }
                ],
                "nullable": true
              },
              "workspace": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/WorkspaceCompact"
                  },
                  {
                    "description": "The workspace this record belongs to.",
                    "readOnly": true,
                    "type": "object"
                  }
                ]
              }
            },
            "type": "object"
          }
        ]
      },
      "RecordItemUpdateRequest": {
        "properties": {
          "custom_fields": {
            "additionalProperties": {
              "description": "\"{custom_field_gid}\" => Value (can be text, enum GID, a number, etc.). For date, use format \"YYYY-MM-DD\" (e.g., 2019-09-15). For date-time, use ISO 8601 date string in UTC (e.g., 2019-09-15T02:06:58.147Z).",
              "type": "string"
            },
            "description": "An object where each key is the GID of a custom field and its corresponding value is either an enum GID, string, number, or object (depending on the custom field type). See the [custom fields guide](/docs/custom-fields-guide) for details on creating and updating custom field values. Only fields already associated with the record's table (i.e. already present in the table's custom field settings) can be written this way; unlike tasks and projects, records do not support force-writing a value for a custom field that is not yet on the table.",
            "type": "object"
          },
          "default_access_level": {
            "description": "The default access level for users who join or are added as members of the record. This isn't applied when the record is private.",
            "enum": [
              "admin",
              "editor",
              "commenter",
              "viewer"
            ],
            "example": "viewer",
            "type": "string"
          },
          "name": {
            "description": "The name of the record.",
            "example": "Q3 renewal",
            "type": "string"
          }
        },
        "type": "object"
      },
      "RecordMembershipCompact": {
        "description": "A user or team's membership in a record.",
        "properties": {
          "access_level": {
            "description": "The member's access level in the record.",
            "enum": [
              "admin",
              "editor",
              "commenter",
              "viewer"
            ],
            "example": "viewer",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "$ref": "#/components/schemas/MemberCompact",
            "description": "Member can be a user or a team."
          },
          "parent": {
            "$ref": "#/components/schemas/RecordItemCompact",
            "description": "The record the user or team is a member of."
          },
          "resource_subtype": {
            "description": "Type of the membership.",
            "example": "record_membership",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "membership",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "RecordMembershipResponse": {
        "$ref": "#/components/schemas/RecordMembershipCompact"
      },
      "RemoveCustomFieldSettingRequest": {
        "properties": {
          "custom_field": {
            "description": "The custom field to remove from this portfolio.",
            "example": "14916",
            "type": "string"
          }
        },
        "required": [
          "custom_field"
        ],
        "type": "object"
      },
      "RemoveFollowersRequest": {
        "properties": {
          "followers": {
            "description": "An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user.",
            "example": "521621,621373",
            "type": "string"
          }
        },
        "required": [
          "followers"
        ],
        "type": "object"
      },
      "RemoveMembersRequest": {
        "properties": {
          "members": {
            "description": "An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user.",
            "example": "521621,621373",
            "type": "string"
          }
        },
        "required": [
          "members"
        ],
        "type": "object"
      },
      "RequestedRoleRequest": {
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the template role in the project template.",
            "example": "1",
            "type": "string"
          },
          "value": {
            "description": "A string identifying a user that should be assigned to the template role. This can either be the string \"me\", an email, or the gid of a user.",
            "example": "123",
            "type": "string"
          }
        },
        "type": "object"
      },
      "ResourceExportCompact": {
        "description": "A *resource_export* object represents a request to bulk export objects for one or more resources.",
        "properties": {
          "completed_at": {
            "description": "The time at which this resource was completed. This will be null if the export is still in progress.",
            "example": "2012-02-22T03:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "created_at": {
            "description": "The time at which the resource export object was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "download_url": {
            "description": "Download this URL to retrieve the full export\nin [JSON Lines](https://jsonlines.org/) format. It will be compressed in a gzip (.gz) container.\n\n*Note: May be null if the export is still in progress or failed.*",
            "example": "https://asana-export-us-east-1.s3.us-east-1.amazonaws.com/2563645399633793/object_export/7588024658887731/download/ object_export_2563645399633793_7588024658887731_2023018-201726.jsonl.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256& X-Amz-Credential=xxxxxxxx&X-Amz-Date=xxxxxxxx&X-Amz-Expires=300&X-Amz-Security-Token=xxxxxxxx& X-Amz-Signature=xxxxxxxx&X-Amz-SignedHeaders=host",
            "format": "uri",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "export_request",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "ResourceExportFilters": {
        "description": "Filters to apply to a resource that will be exported. These filters can be used to narrow down the resources that are included in the export.",
        "properties": {
          "assigned_by.any": {
            "description": "Filter by the users who assigned the resource. This array accepts a list of user GIDs. This is only applicable to tasks.",
            "items": {
              "example": "12345",
              "type": "string"
            },
            "type": "array"
          },
          "assignee.any": {
            "description": "Filter by the users who are assigned to the resource. This array accepts a list of user GIDs. This is only applicable to tasks.",
            "items": {
              "example": "12345",
              "type": "string"
            },
            "type": "array"
          },
          "commented_on_by.any": {
            "description": "Filter by the users who commented on the resource. This array accepts a list of user GIDs.",
            "items": {
              "example": "12345",
              "type": "string"
            },
            "type": "array"
          },
          "created_at.after": {
            "description": "Filter results to resources created after a specified date and time.",
            "example": "2023-01-01T00:00:00Z",
            "format": "date-time",
            "type": "string"
          },
          "created_at.before": {
            "description": "Filter results to resources created before a specified date and time.",
            "example": "2023-01-01T00:00:00Z",
            "format": "date-time",
            "type": "string"
          },
          "created_by.any": {
            "description": "Filter by the users who created the resource. This array accepts a list of user GIDs.",
            "items": {
              "example": "12345",
              "type": "string"
            },
            "type": "array"
          },
          "followers.any": {
            "description": "Filter by the users who are following the resource. This array accepts a list of user GIDs.",
            "items": {
              "example": "12345",
              "type": "string"
            },
            "type": "array"
          },
          "liked_by.any": {
            "description": "Filter by the users who liked the resource. This array accepts a list of user GIDs.",
            "items": {
              "example": "12345",
              "type": "string"
            },
            "type": "array"
          },
          "modified_at.after": {
            "description": "Filter results to resources modified after a specified date and time.",
            "example": "2023-01-01T00:00:00Z",
            "format": "date-time",
            "type": "string"
          },
          "modified_at.before": {
            "description": "Filter results to resources modified before a specified date and time.",
            "example": "2023-01-01T00:00:00Z",
            "format": "date-time",
            "type": "string"
          }
        },
        "type": "object"
      },
      "ResourceExportRequest": {
        "description": "A *resource_export* request starts a job to bulk export objects for one or more resources.",
        "properties": {
          "export_request_parameters": {
            "description": "An object containing the parameters for the export request. The keys of this object are the GIDs of the resources to be exported. The values are objects with additional parameters for each resource.",
            "items": {
              "$ref": "#/components/schemas/ResourceExportRequestParameter"
            },
            "type": "array"
          },
          "workspace": {
            "description": "Gid of a workspace.",
            "example": "12345",
            "type": "string"
          }
        },
        "type": "object"
      },
      "ResourceExportRequestParameter": {
        "properties": {
          "fields": {
            "description": "An array of fields to include for the resource type. If not provided, all non-optional fields for the resource type will be included. This conforms to the fields optional parameter available for all Asana endpoints which is documented [here](https://developers.asana.com/docs/inputoutput-options)",
            "items": {
              "example": "gid",
              "type": "string"
            },
            "type": "array"
          },
          "filters": {
            "$ref": "#/components/schemas/ResourceExportFilters"
          },
          "resource_type": {
            "description": "The type of the resource to be exported. This can be a task, team, or message.",
            "example": "task",
            "type": "string"
          }
        },
        "type": "object"
      },
      "ResourceExportResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "new_resource_export": {
            "$ref": "#/components/schemas/ResourceExportCompact"
          },
          "resource_subtype": {
            "description": "A *resource_export* object represents a request to bulk export objects for one or more resources.",
            "example": "export_request",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "job",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "status": {
            "description": "The current status of this job.",
            "enum": [
              "not_started",
              "in_progress",
              "succeeded",
              "failed"
            ],
            "example": "succeeded",
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "RuleTriggerRequest": {
        "properties": {
          "action_data": {
            "additionalProperties": true,
            "description": "The dynamic keys and values of the request. These fields are intended to be used in the action for the rule associated with this trigger.",
            "example": {
              "jira_ticket_id": "123",
              "jira_ticket_name": "Test"
            },
            "type": "object"
          },
          "resource": {
            "description": "The ID of the resource. For the duration of the beta, this resource is always a task, and this task must exist in the project in which the rule is created.",
            "example": "12345",
            "type": "string"
          }
        },
        "required": [
          "resource",
          "action_data"
        ],
        "type": "object"
      },
      "RuleTriggerResponse": {
        "properties": {
          "message": {
            "description": "Message providing more detail about the result",
            "example": "Successfully saved the payload and ran the rule",
            "type": "string"
          }
        },
        "type": "object"
      },
      "SectionBase": {
        "$ref": "#/components/schemas/SectionCompact"
      },
      "SectionCompact": {
        "description": "A *section* is a subdivision of a project that groups tasks together. It can either be a header above a list of tasks in a list view or a column in a board view of a project.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the section (i.e. the text displayed as the section header).",
            "example": "Next Actions",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "section",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "SectionRequest": {
        "properties": {
          "insert_after": {
            "description": "An existing section within this project after which the added section should be inserted. Cannot be provided together with insert_before.",
            "example": "987654",
            "type": "string"
          },
          "insert_before": {
            "description": "An existing section within this project before which the added section should be inserted. Cannot be provided together with insert_after.",
            "example": "86420",
            "type": "string"
          },
          "name": {
            "description": "The text to be displayed as the section name. This cannot be an empty string.",
            "example": "Next Actions",
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "SectionResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SectionBase"
          },
          {
            "properties": {
              "created_at": {
                "description": "The time at which this resource was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "project": {
                "$ref": "#/components/schemas/ProjectCompact"
              },
              "projects": {
                "description": "*Deprecated - please use project instead*",
                "items": {
                  "$ref": "#/components/schemas/ProjectCompact"
                },
                "readOnly": true,
                "type": "array"
              }
            },
            "type": "object"
          }
        ]
      },
      "SectionTaskInsertRequest": {
        "properties": {
          "insert_after": {
            "description": "An existing task within this section after which the added task should be inserted. Cannot be provided together with insert_before.",
            "example": "987654",
            "type": "string"
          },
          "insert_before": {
            "description": "An existing task within this section before which the added task should be inserted. Cannot be provided together with insert_after.",
            "example": "86420",
            "type": "string"
          },
          "task": {
            "description": "The task to add to this section.",
            "example": "123456",
            "type": "string"
          }
        },
        "required": [
          "task"
        ],
        "type": "object"
      },
      "StatusUpdateBase": {
        "allOf": [
          {
            "$ref": "#/components/schemas/StatusUpdateCompact"
          },
          {
            "properties": {
              "html_text": {
                "description": "[Opt In](/docs/inputoutput-options). The text content of the status update with formatting as HTML. See [rich text](/docs/rich-text).",
                "example": "<body>The project <strong>is</strong> moving forward according to plan...</body>",
                "type": "string"
              },
              "status_type": {
                "description": "The type associated with the status update. This represents the current state of the object this object is on.\n\nThe valid values for `status_type` depend on the parent of the status update:\n- Projects: `on_track`, `at_risk`, `off_track`, `on_hold`, `complete`, `dropped`.\n- Portfolios: `on_track`, `at_risk`, `off_track`, `on_hold`, `complete`, `dropped`.\n- Goals: `on_track`, `at_risk`, `off_track`, `achieved`, `partial`, `missed`, `dropped`.",
                "enum": [
                  "on_track",
                  "at_risk",
                  "off_track",
                  "on_hold",
                  "complete",
                  "achieved",
                  "partial",
                  "missed",
                  "dropped"
                ],
                "type": "string"
              },
              "text": {
                "description": "The text content of the status update.",
                "example": "The project is moving forward according to plan...",
                "type": "string"
              }
            },
            "required": [
              "text",
              "status_type"
            ],
            "type": "object"
          }
        ]
      },
      "StatusUpdateCompact": {
        "description": "A *status update* is an update on the progress of a particular project, portfolio, or goal, and is sent out to all of its parent's followers when created. These updates include both text describing the update and a `status_type` intended to represent the overall state of the object.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe `resource_subtype`s for `status` objects represent the type of their parent.",
            "enum": [
              "project_status_update",
              "portfolio_status_update",
              "goal_status_update"
            ],
            "example": "project_status_update",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "status_update",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "title": {
            "description": "The title of the status update.",
            "example": "Status Update - Jun 15",
            "type": "string"
          }
        },
        "type": "object"
      },
      "StatusUpdateRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/StatusUpdateBase"
          },
          {
            "properties": {
              "parent": {
                "description": "The id of parent to send this status update to. This can be a project, goal or portfolio.",
                "type": "string"
              }
            },
            "required": [
              "parent"
            ],
            "type": "object"
          }
        ]
      },
      "StatusUpdateResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/StatusUpdateBase"
          },
          {
            "properties": {
              "author": {
                "$ref": "#/components/schemas/UserCompact"
              },
              "created_at": {
                "description": "The time at which this resource was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "created_by": {
                "$ref": "#/components/schemas/UserCompact"
              },
              "hearted": {
                "description": "*Deprecated - please use liked instead* True if the status is hearted by the authorized user, false if not.",
                "example": true,
                "readOnly": true,
                "type": "boolean"
              },
              "hearts": {
                "description": "*Deprecated - please use likes instead* Array of likes for users who have hearted this status.",
                "items": {
                  "$ref": "#/components/schemas/Like"
                },
                "readOnly": true,
                "type": "array"
              },
              "liked": {
                "description": "True if the status is liked by the authorized user, false if not.",
                "example": true,
                "type": "boolean"
              },
              "likes": {
                "description": "Array of likes for users who have liked this status.",
                "items": {
                  "$ref": "#/components/schemas/Like"
                },
                "readOnly": true,
                "type": "array"
              },
              "modified_at": {
                "description": "The time at which this project status was last modified.\n*Note: This does not currently reflect any changes in associations such as comments that may have been added or removed from the status.*",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "num_hearts": {
                "description": "*Deprecated - please use likes instead* The number of users who have hearted this status.",
                "example": 5,
                "readOnly": true,
                "type": "integer"
              },
              "num_likes": {
                "description": "The number of users who have liked this status.",
                "example": 5,
                "readOnly": true,
                "type": "integer"
              },
              "parent": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ProjectCompact"
                  },
                  {
                    "description": "The parent of the status update. This can be a project, goal or portfolio, and indicates that this status was sent on that object.",
                    "type": "object"
                  }
                ]
              },
              "reaction_summary": {
                "description": "Summary of emoji reactions on this status.",
                "items": {
                  "$ref": "#/components/schemas/ReactionSummaryItemCompact"
                },
                "readOnly": true,
                "type": "array"
              }
            },
            "type": "object"
          }
        ]
      },
      "StoryBase": {
        "description": "A story represents an activity associated with an object in the Asana system.",
        "properties": {
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_text": {
            "description": "[Opt In](/docs/inputoutput-options). HTML formatted text for a comment. This will not include the name of the creator. See [rich text](/docs/rich-text).",
            "example": "<body>This is a comment.</body>",
            "type": "string"
          },
          "is_pinned": {
            "description": "*Conditional*. Whether the story should be pinned on the resource.",
            "example": false,
            "type": "boolean"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "example": "comment_added",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "story",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "sticker_name": {
            "description": "The name of the sticker in this story. `null` if there is no sticker.",
            "enum": [
              "green_checkmark",
              "people_dancing",
              "dancing_unicorn",
              "heart",
              "party_popper",
              "people_waving_flags",
              "splashing_narwhal",
              "trophy",
              "yeti_riding_unicorn",
              "celebrating_people",
              "determined_climbers",
              "phoenix_spreading_love"
            ],
            "example": "dancing_unicorn",
            "type": "string"
          },
          "text": {
            "description": "The plain text of the comment to add. Cannot be used with html_text.",
            "example": "This is a comment.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "StoryCompact": {
        "description": "A story represents an activity associated with an object in the Asana system.",
        "properties": {
          "anchor_gid": {
            "description": "*Conditional*. The GID of the object this comment is anchored to. For a top-level task comment this is the task GID; for a threaded reply this is the parent comment's envelope GID (`comment_gid`). Also present on sticker stories. Request with `opt_fields=anchor_gid` on story reads.",
            "example": "12345",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "comment_gid": {
            "description": "*Conditional*. The GID of this comment's envelope, distinct from the story `gid`. Request with `opt_fields=comment_gid` on story reads. For a top-level task comment, pass this value as `parent_comment` when creating a threaded reply. Null for a legacy comment without an envelope; absent on non-comment stories.",
            "example": "12345",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "created_by": {
            "$ref": "#/components/schemas/UserCompact"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "example": "comment_added",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "story",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "text": {
            "description": "*Create-only*. Human-readable text for the story or comment.\nThis will not include the name of the creator.\n*Note: This is not guaranteed to be stable for a given type of story. For example, text for a reassignment may not always say “assigned to …” as the text for a story can both be edited and change based on the language settings of the user making the request.*\nUse the `resource_subtype` property to discover the action that created the story.",
            "example": "marked today",
            "type": "string"
          }
        },
        "type": "object"
      },
      "StoryRequest": {
        "$ref": "#/components/schemas/StoryBase"
      },
      "StoryResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/StoryBase"
          },
          {
            "properties": {
              "anchor_gid": {
                "description": "*Conditional*. The GID of the object this comment is anchored to. For a top-level task comment this is the task GID; for a threaded reply this is the parent comment's envelope GID (`comment_gid`). Also present on sticker stories. Request with `opt_fields=anchor_gid` on story reads.",
                "example": "12345",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "assignee": {
                "$ref": "#/components/schemas/UserCompact",
                "description": "*Conditional*",
                "readOnly": true
              },
              "comment_gid": {
                "description": "*Conditional*. The GID of this comment's envelope, distinct from the story `gid`. Request with `opt_fields=comment_gid` on story reads. For a top-level task comment, pass this value as `parent_comment` when creating a threaded reply. Null for a legacy comment without an envelope; absent on non-comment stories.",
                "example": "12345",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "created_by": {
                "$ref": "#/components/schemas/UserCompact"
              },
              "custom_field": {
                "$ref": "#/components/schemas/CustomFieldCompact",
                "description": "*Conditional*",
                "readOnly": true
              },
              "dependency": {
                "$ref": "#/components/schemas/TaskCompact",
                "description": "*Conditional*",
                "readOnly": true
              },
              "duplicate_of": {
                "$ref": "#/components/schemas/TaskCompact",
                "description": "*Conditional*",
                "readOnly": true
              },
              "duplicated_from": {
                "$ref": "#/components/schemas/TaskCompact",
                "description": "*Conditional*",
                "readOnly": true
              },
              "follower": {
                "$ref": "#/components/schemas/UserCompact",
                "description": "*Conditional*",
                "readOnly": true
              },
              "hearted": {
                "description": "*Deprecated - please use likes instead*\n*Conditional*. True if the story is hearted by the authorized user, false if not.",
                "example": false,
                "readOnly": true,
                "type": "boolean"
              },
              "hearts": {
                "description": "*Deprecated - please use likes instead*\n\n*Conditional*. Array of likes for users who have hearted this story.",
                "items": {
                  "$ref": "#/components/schemas/Like"
                },
                "readOnly": true,
                "type": "array"
              },
              "is_editable": {
                "description": "*Conditional*. Whether the text of the story can be edited after creation.",
                "example": false,
                "readOnly": true,
                "type": "boolean"
              },
              "is_edited": {
                "description": "*Conditional*. Whether the text of the story has been edited after creation.",
                "example": false,
                "readOnly": true,
                "type": "boolean"
              },
              "liked": {
                "description": "*Conditional*. True if the story is liked by the authorized user, false if not.",
                "example": false,
                "readOnly": true,
                "type": "boolean"
              },
              "likes": {
                "description": "*Conditional*. Array of likes for users who have liked this story.",
                "items": {
                  "$ref": "#/components/schemas/Like"
                },
                "readOnly": true,
                "type": "array"
              },
              "new_approval_status": {
                "description": "*Conditional*. The new value of approval status.",
                "example": "approved",
                "readOnly": true,
                "type": "string"
              },
              "new_date_value": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/StoryResponseDates"
                  },
                  {
                    "description": "*Conditional* The new value of a date custom field story."
                  }
                ],
                "readOnly": true
              },
              "new_dates": {
                "$ref": "#/components/schemas/StoryResponseDates"
              },
              "new_enum_value": {
                "$ref": "#/components/schemas/EnumOption",
                "description": "*Conditional*",
                "readOnly": true
              },
              "new_multi_enum_values": {
                "description": "*Conditional*. The new value of a multi-enum custom field story.",
                "items": {
                  "$ref": "#/components/schemas/EnumOption"
                },
                "readOnly": true,
                "type": "array"
              },
              "new_name": {
                "description": "*Conditional* The updated name of the task after a name change.",
                "example": "This is the new name",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "new_number_value": {
                "description": "*Conditional* The new value of a number-type custom field after the update.",
                "example": 2,
                "readOnly": true,
                "type": "integer"
              },
              "new_people_value": {
                "description": "*Conditional*. The new value of a people custom field story.",
                "items": {
                  "$ref": "#/components/schemas/UserCompact"
                },
                "readOnly": true,
                "type": "array"
              },
              "new_resource_subtype": {
                "description": "*Conditional*",
                "example": "milestone",
                "readOnly": true,
                "type": "string"
              },
              "new_section": {
                "$ref": "#/components/schemas/SectionCompact",
                "description": "*Conditional*",
                "readOnly": true
              },
              "new_text_value": {
                "description": "*Conditional* The new value of a text-type field after it was updated.",
                "example": "This is the new text",
                "readOnly": true,
                "type": "string"
              },
              "num_hearts": {
                "description": "*Deprecated - please use likes instead*\n\n*Conditional*. The number of users who have hearted this story.",
                "example": 5,
                "readOnly": true,
                "type": "integer"
              },
              "num_likes": {
                "description": "*Conditional*. The number of users who have liked this story.",
                "example": 5,
                "readOnly": true,
                "type": "integer"
              },
              "old_approval_status": {
                "description": "*Conditional*. The old value of approval status.",
                "example": "pending",
                "readOnly": true,
                "type": "string"
              },
              "old_date_value": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/StoryResponseDates"
                  },
                  {
                    "description": "*Conditional*. The old value of a date custom field story."
                  }
                ],
                "readOnly": true
              },
              "old_dates": {
                "$ref": "#/components/schemas/StoryResponseDates"
              },
              "old_enum_value": {
                "$ref": "#/components/schemas/EnumOption",
                "description": "*Conditional*",
                "readOnly": true
              },
              "old_multi_enum_values": {
                "description": "*Conditional*. The old value of a multi-enum custom field story.",
                "items": {
                  "$ref": "#/components/schemas/EnumOption"
                },
                "readOnly": true,
                "type": "array"
              },
              "old_name": {
                "description": "*Conditional* The previous name of the task before a name change.",
                "example": "This was the old name",
                "type": "string"
              },
              "old_number_value": {
                "description": "*Conditional* The previous value of a number-type custom field before the update.",
                "example": 1,
                "nullable": true,
                "readOnly": true,
                "type": "integer"
              },
              "old_people_value": {
                "description": "*Conditional*. The old value of a people custom field story.",
                "items": {
                  "$ref": "#/components/schemas/UserCompact"
                },
                "readOnly": true,
                "type": "array"
              },
              "old_resource_subtype": {
                "description": "*Conditional*",
                "example": "default_task",
                "readOnly": true,
                "type": "string"
              },
              "old_section": {
                "$ref": "#/components/schemas/SectionCompact",
                "description": "*Conditional*",
                "readOnly": true
              },
              "old_text_value": {
                "description": "*Conditional* The previous value of a text-type field before it was updated.",
                "example": "This was the old text",
                "readOnly": true,
                "type": "string"
              },
              "previews": {
                "description": "<p><strong style={{ color: \"#4573D2\" }}>Full object requires scope: </strong><code>attachments:read</code></p>\n\n*Conditional*. A collection of previews to be displayed in the story.\n\n*Note: This property only exists for comment stories.*",
                "items": {
                  "$ref": "#/components/schemas/Preview"
                },
                "readOnly": true,
                "type": "array"
              },
              "project": {
                "$ref": "#/components/schemas/ProjectCompact",
                "description": "*Conditional*",
                "readOnly": true
              },
              "reaction_summary": {
                "description": "Summary of emoji reactions on this story.",
                "items": {
                  "$ref": "#/components/schemas/ReactionSummaryItemCompact"
                },
                "readOnly": true,
                "type": "array"
              },
              "source": {
                "description": "The component of the Asana product the user used to trigger the story.",
                "enum": [
                  "web",
                  "email",
                  "mobile",
                  "api",
                  "unknown"
                ],
                "example": "web",
                "readOnly": true,
                "type": "string"
              },
              "story": {
                "$ref": "#/components/schemas/StoryCompact",
                "description": "*Conditional*",
                "readOnly": true
              },
              "tag": {
                "$ref": "#/components/schemas/TagCompact",
                "description": "*Conditional*",
                "readOnly": true
              },
              "target": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TaskCompact"
                  },
                  {
                    "description": "The object this story is associated with. Currently may only be a task.",
                    "readOnly": true,
                    "type": "object"
                  }
                ]
              },
              "task": {
                "$ref": "#/components/schemas/TaskCompact",
                "description": "*Conditional*",
                "readOnly": true
              },
              "type": {
                "enum": [
                  "comment",
                  "system"
                ],
                "example": "comment",
                "readOnly": true,
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "StoryResponseDates": {
        "description": "*Conditional*",
        "properties": {
          "due_at": {
            "description": "The UTC date and time on which this task is due, or null if the task has no due time. This takes an ISO 8601 date string in UTC and should not be used together with `due_on`.",
            "example": "2019-09-15T02:06:58.158Z",
            "format": "date-time",
            "nullable": true,
            "type": "string"
          },
          "due_on": {
            "description": "The localized day on which this goal is due. This takes a date with format `YYYY-MM-DD`.",
            "example": "2019-09-15",
            "format": "date",
            "type": "string"
          },
          "start_on": {
            "description": "The day on which work for this goal begins, or null if the goal has no start date. This takes a date with `YYYY-MM-DD` format, and cannot be set unless there is an accompanying due date.",
            "example": "2019-09-14",
            "format": "date",
            "nullable": true,
            "type": "string"
          }
        },
        "readOnly": true,
        "type": "object"
      },
      "TableBase": {
        "$ref": "#/components/schemas/TableCompact"
      },
      "TableCompact": {
        "description": "A *table* is a container for structured records (rows), with columns defined by custom field settings.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the table.",
            "example": "Vendor contracts",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "table",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "TableMembershipCompact": {
        "description": "A user or team's membership in a table.",
        "properties": {
          "access_level": {
            "description": "The member's access level in the table.",
            "enum": [
              "admin",
              "editor",
              "commenter",
              "viewer"
            ],
            "example": "viewer",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "$ref": "#/components/schemas/MemberCompact",
            "description": "Member can be a user or a team."
          },
          "parent": {
            "$ref": "#/components/schemas/TableCompact",
            "description": "The table the user or team is a member of."
          },
          "resource_subtype": {
            "description": "Type of the membership.",
            "example": "table_membership",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "membership",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "TableMembershipResponse": {
        "$ref": "#/components/schemas/TableMembershipCompact"
      },
      "TableRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TableBase"
          },
          {
            "properties": {
              "workspace": {
                "description": "*Create-only*. The workspace or organization in which this table will be created. Once created, tables cannot be moved to a different workspace.",
                "example": "1331",
                "type": "string"
              }
            },
            "required": [
              "name",
              "workspace"
            ],
            "type": "object"
          }
        ]
      },
      "TableResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TableBase"
          },
          {
            "properties": {
              "created_at": {
                "description": "The time at which this resource was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "custom_field_settings": {
                "description": "Array of custom field definitions that are enabled for the table. These represent which custom fields are available to records in the table, but do not include any values.",
                "items": {
                  "$ref": "#/components/schemas/CustomFieldTableSettingResponse"
                },
                "readOnly": true,
                "type": "array"
              },
              "default_access_level": {
                "description": "The default access level for users who join or are added as members of the table.",
                "enum": [
                  "admin",
                  "editor",
                  "commenter",
                  "viewer"
                ],
                "example": "viewer",
                "type": "string"
              },
              "modified_at": {
                "description": "The time at which this table was last modified.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "workspace": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/WorkspaceCompact"
                  },
                  {
                    "description": "*Create-only*. The workspace or organization this table is associated with. Once created, tables cannot be moved to a different workspace. This attribute can only be specified at creation time.",
                    "readOnly": true,
                    "type": "object"
                  }
                ]
              }
            },
            "type": "object"
          }
        ]
      },
      "TableUpdateRequest": {
        "properties": {
          "default_access_level": {
            "description": "The default access level for users who join or are added as members of the table.",
            "enum": [
              "admin",
              "editor",
              "commenter",
              "viewer"
            ],
            "example": "viewer",
            "type": "string"
          },
          "name": {
            "description": "The name of the table.",
            "example": "Vendor contracts",
            "type": "string"
          }
        },
        "type": "object"
      },
      "TagBase": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TagCompact"
          },
          {
            "properties": {
              "color": {
                "description": "Color of the tag.",
                "enum": [
                  "dark-pink",
                  "dark-green",
                  "dark-blue",
                  "dark-red",
                  "dark-teal",
                  "dark-brown",
                  "dark-orange",
                  "dark-purple",
                  "dark-warm-gray",
                  "light-pink",
                  "light-green",
                  "light-blue",
                  "light-red",
                  "light-teal",
                  "light-brown",
                  "light-orange",
                  "light-purple",
                  "light-warm-gray",
                  null
                ],
                "example": "light-green",
                "nullable": true,
                "type": "string"
              },
              "notes": {
                "description": "Free-form textual information associated with the tag (i.e. its description).",
                "example": "Mittens really likes the stuff from Humboldt.",
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "TagBaseRequest": {
        "$ref": "#/components/schemas/TagBase"
      },
      "TagCompact": {
        "description": "A *tag* is a label that can be attached to any task in Asana. It exists in a single workspace or organization.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "Name of the tag. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.",
            "example": "Stuff to buy",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "tag",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "TagCreateRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TagBaseRequest"
          },
          {
            "properties": {
              "followers": {
                "description": "An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user.",
                "example": [
                  "12345",
                  "42563"
                ],
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "workspace": {
                "description": "Gid of an object.",
                "example": "12345",
                "type": "string",
                "x-env-variable": true
              }
            },
            "type": "object"
          }
        ]
      },
      "TagCreateTagForWorkspaceRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TagBase"
          },
          {
            "properties": {
              "followers": {
                "description": "An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user.",
                "example": [
                  "12345",
                  "42563"
                ],
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            },
            "type": "object"
          }
        ]
      },
      "TagResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TagBase"
          },
          {
            "properties": {
              "created_at": {
                "description": "The time at which this resource was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "followers": {
                "description": "Array of users following this tag.",
                "items": {
                  "$ref": "#/components/schemas/UserCompact"
                },
                "readOnly": true,
                "type": "array"
              },
              "permalink_url": {
                "description": "A url that points directly to the object within Asana.",
                "example": "https://app.asana.com/0/resource/123456789/list",
                "readOnly": true,
                "type": "string"
              },
              "workspace": {
                "$ref": "#/components/schemas/WorkspaceCompact"
              }
            },
            "type": "object"
          }
        ]
      },
      "TagUpdateRequest": {
        "$ref": "#/components/schemas/TagBaseRequest"
      },
      "TaskAddFollowersRequest": {
        "properties": {
          "followers": {
            "description": "An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user.",
            "example": [
              "13579",
              "321654"
            ],
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "followers"
        ],
        "type": "object"
      },
      "TaskAddProjectRequest": {
        "properties": {
          "insert_after": {
            "description": "A task in the project to insert the task after, or `null` to insert at the beginning of the list. When used with `section`, `null` will insert at the beginning of the specified section, otherwise the task must be in the specified section.",
            "example": "124816",
            "nullable": true,
            "type": "string"
          },
          "insert_before": {
            "description": "A task in the project to insert the task before, or `null` to insert at the end of the list. When used with `section`, `null` will insert at the end of the specified section, otherwise the task must be in the specified section.",
            "example": "432134",
            "nullable": true,
            "type": "string"
          },
          "project": {
            "description": "The project to add the task to.",
            "example": "13579",
            "type": "string"
          },
          "section": {
            "description": "A section in the project to insert the task into. The task will be inserted at the bottom of the section unless combined with `insert_before: null` (end of section) or `insert_after: null` (beginning of section). Can also be combined with non-null `insert_before` or `insert_after` to position relative to a task within the section.",
            "example": "987654",
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "project"
        ],
        "type": "object"
      },
      "TaskAddTagRequest": {
        "properties": {
          "tag": {
            "description": "The tag's gid to add to the task.",
            "example": "13579",
            "type": "string"
          }
        },
        "required": [
          "tag"
        ],
        "type": "object"
      },
      "TaskBase": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TaskCompact"
          },
          {
            "properties": {
              "actual_time_minutes": {
                "description": "<p><strong style={{ color: \"#4573D2\" }}>Full object requires scope: </strong><code>time_tracking_entries:read</code></p>\n\nThis value represents the sum of all the Time Tracking entries in the Actual Time field on a given Task. It is represented as a nullable long value.",
                "example": 200,
                "nullable": true,
                "readOnly": true,
                "type": "number"
              },
              "approval_status": {
                "description": "*Conditional* Reflects the approval status of this task. This field is kept in sync with `completed`, meaning `pending` translates to false while `approved`, `rejected`, and `changes_requested` translate to true. If you set completed to true, this field will be set to `approved`.",
                "enum": [
                  "pending",
                  "approved",
                  "rejected",
                  "changes_requested"
                ],
                "example": "pending",
                "type": "string"
              },
              "assigned_by": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/UserCompact"
                  },
                  {
                    "description": "The user who assigned the task. This field is only returned when requesting it via opt_fields, and will be null if the task has no specific assigner (e.g., tasks created without an explicit assigner).",
                    "readOnly": true
                  }
                ],
                "nullable": true
              },
              "assignee_status": {
                "description": "*Deprecated* Scheduling status of this task for the user it is assigned to. This field can only be set if the assignee is non-null. Setting this field to \"inbox\" or \"upcoming\" inserts it at the top of the section, while the other options will insert at the bottom.",
                "enum": [
                  "today",
                  "upcoming",
                  "later",
                  "new",
                  "inbox"
                ],
                "example": "upcoming",
                "type": "string"
              },
              "completed": {
                "description": "True if the task is currently marked complete, false if not.",
                "example": false,
                "type": "boolean"
              },
              "completed_at": {
                "description": "The time at which this task was completed, or null if the task is incomplete.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "completed_by": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/UserCompact"
                  },
                  {
                    "readOnly": true
                  }
                ],
                "nullable": true
              },
              "created_at": {
                "description": "The time at which this resource was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "dependencies": {
                "description": "[Opt In](/docs/inputoutput-options). Array of resources referencing tasks that this task depends on. The objects contain only the gid of the dependency.",
                "items": {
                  "$ref": "#/components/schemas/AsanaResource"
                },
                "readOnly": true,
                "type": "array"
              },
              "dependents": {
                "description": "[Opt In](/docs/inputoutput-options). Array of resources referencing tasks that depend on this task. The objects contain only the ID of the dependent.",
                "items": {
                  "$ref": "#/components/schemas/AsanaResource"
                },
                "readOnly": true,
                "type": "array"
              },
              "due_at": {
                "description": "The UTC date and time on which this task is due, or null if the task has no due time. This takes an ISO 8601 date string in UTC and should not be used together with `due_on`.",
                "example": "2019-09-15T02:06:58.147Z",
                "format": "date-time",
                "nullable": true,
                "type": "string"
              },
              "due_on": {
                "description": "The localized date on which this task is due, or null if the task has no due date. This takes a date with `YYYY-MM-DD` format and should not be used together with `due_at`.",
                "example": "2019-09-15",
                "format": "date",
                "nullable": true,
                "type": "string"
              },
              "external": {
                "description": "*OAuth Required*. *Conditional*. This field is returned only if external values are set or included by using [Opt In](/docs/inputoutput-options).\nThe external field allows you to store app-specific metadata on tasks, including a gid that can be used to retrieve tasks and a data blob that can store app-specific character strings. Note that you will need to authenticate with Oauth to access or modify this data. Once an external gid is set, you can use the notation `external:custom_gid` to reference your object anywhere in the API where you may use the original object gid. See the page on Custom External Data for more details.",
                "example": {
                  "data": "A blob of information",
                  "gid": "my_gid"
                },
                "properties": {
                  "data": {
                    "example": "A blob of information.",
                    "type": "string"
                  },
                  "gid": {
                    "example": "1234",
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "has_subtasks_date_mismatch": {
                "description": "[Opt In](/docs/inputoutput-options). True when one or more descendant subtasks have dates outside the task's own date range. This field reflects the latest computed rollup state and returns false when no rollup has been computed.",
                "example": true,
                "readOnly": true,
                "type": "boolean"
              },
              "hearted": {
                "description": "*Deprecated - please use liked instead* True if the task is hearted by the authorized user, false if not.",
                "example": true,
                "readOnly": true,
                "type": "boolean"
              },
              "hearts": {
                "description": "*Deprecated - please use likes instead* Array of likes for users who have hearted this task.",
                "items": {
                  "$ref": "#/components/schemas/Like"
                },
                "readOnly": true,
                "type": "array"
              },
              "html_notes": {
                "description": "[Opt In](/docs/inputoutput-options). The notes of the text with formatting as HTML. See [rich text](/docs/rich-text).",
                "example": "<body>Mittens <em>really</em> likes the stuff from Humboldt.</body>",
                "type": "string"
              },
              "is_rendered_as_separator": {
                "description": "[Opt In](/docs/inputoutput-options). In some contexts tasks can be rendered as a visual separator; for instance, subtasks can appear similar to [sections](/reference/sections) without being true `section` objects. If a `task` object is rendered this way in any context it will have the property `is_rendered_as_separator` set to `true`. This parameter only applies to regular tasks with `resource_subtype` of `default_task`. Tasks with `resource_subtype` of `milestone`, `approval`, or custom task types will not have this property and cannot be rendered as separators.",
                "example": false,
                "readOnly": true,
                "type": "boolean"
              },
              "liked": {
                "description": "True if the task is liked by the authorized user, false if not.",
                "example": true,
                "type": "boolean"
              },
              "likes": {
                "description": "Array of likes for users who have liked this task.",
                "items": {
                  "$ref": "#/components/schemas/Like"
                },
                "readOnly": true,
                "type": "array"
              },
              "memberships": {
                "description": "<p><strong style={{ color: \"#4573D2\" }}>Full object requires scope: </strong><code>projects:read</code>, <code>project_sections:read</code></p>\n\n*Create-only*. Array of projects this task is associated with and the section it is in. At task creation time, this array can be used to add the task to specific sections. After task creation, these associations can be modified using the `addProject` and `removeProject` endpoints. Note that over time, more types of memberships may be added to this property.",
                "items": {
                  "$ref": "#/components/schemas/TaskMembership"
                },
                "readOnly": true,
                "type": "array"
              },
              "modified_at": {
                "description": "The time at which this task was last modified.\n\nThe following conditions will change `modified_at`:\n\n- story is created on a task\n- story is trashed on a task\n- attachment is trashed on a task\n- task is assigned or unassigned\n- custom field value is changed\n- the task itself is trashed\n- Or if any of the following fields are updated:\n  - completed\n  - name\n  - due_date\n  - description\n  - attachments\n  - items\n  - schedule_status\n\nThe following conditions will _not_ change `modified_at`:\n\n- moving to a new container (project, portfolio, etc)\n- comments being added to the task (but the stories they generate\n  _will_ affect `modified_at`)",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "name": {
                "description": "Name of the task. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.",
                "example": "Buy catnip",
                "type": "string"
              },
              "notes": {
                "description": "Free-form textual information associated with the task (i.e. its description).",
                "example": "Mittens really likes the stuff from Humboldt.",
                "type": "string"
              },
              "num_hearts": {
                "description": "*Deprecated - please use likes instead* The number of users who have hearted this task.",
                "example": 5,
                "readOnly": true,
                "type": "integer"
              },
              "num_likes": {
                "description": "The number of users who have liked this task.",
                "example": 5,
                "readOnly": true,
                "type": "integer"
              },
              "num_subtasks": {
                "description": "[Opt In](/docs/inputoutput-options). The number of subtasks on this task.\n",
                "example": 3,
                "readOnly": true,
                "type": "integer"
              },
              "start_at": {
                "description": "Date and time on which work begins for the task, or null if the task has no start time. This takes an ISO 8601 date string in UTC and should not be used together with `start_on`.\n*Note: `due_at` must be present in the request when setting or unsetting the `start_at` parameter.*",
                "example": "2019-09-14T02:06:58.147Z",
                "format": "date-time",
                "nullable": true,
                "type": "string"
              },
              "start_on": {
                "description": "The day on which work begins for the task , or null if the task has no start date. This takes a date with `YYYY-MM-DD` format and should not be used together with `start_at`.\n*Note: `due_on` or `due_at` must be present in the request when setting or unsetting the `start_on` parameter.*",
                "example": "2019-09-14",
                "format": "date",
                "nullable": true,
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "TaskCompact": {
        "description": "The *task* is the basic object around which many operations in Asana are centered.",
        "properties": {
          "created_by": {
            "description": "[Opt In](/docs/inputoutput-options). A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource.",
                "example": "1111",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of resource.",
                "example": "user",
                "type": "string"
              }
            },
            "readOnly": true,
            "type": "object"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the task.",
            "example": "Bug Task",
            "type": "string"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe resource_subtype `milestone` represent a single moment in time. This means tasks with this subtype cannot have a start_date.",
            "enum": [
              "default_task",
              "milestone",
              "approval",
              "custom"
            ],
            "example": "default_task",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "TaskCountResponse": {
        "description": "A response object returned from the task count endpoint.",
        "properties": {
          "num_completed_milestones": {
            "description": "The number of completed milestones in a project.",
            "example": 3,
            "type": "integer"
          },
          "num_completed_tasks": {
            "description": "The number of completed tasks in a project.",
            "example": 150,
            "type": "integer"
          },
          "num_incomplete_milestones": {
            "description": "The number of incomplete milestones in a project.",
            "example": 7,
            "type": "integer"
          },
          "num_incomplete_tasks": {
            "description": "The number of incomplete tasks in a project.",
            "example": 50,
            "type": "integer"
          },
          "num_milestones": {
            "description": "The number of milestones in a project.",
            "example": 10,
            "type": "integer"
          },
          "num_tasks": {
            "description": "The number of tasks in a project.",
            "example": 200,
            "type": "integer"
          }
        },
        "type": "object"
      },
      "TaskCreateRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TaskRequestBase"
          },
          {
            "properties": {
              "followers": {
                "description": "*Create-Only* An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user. In order to change followers on an existing task use `addFollowers` and `removeFollowers`.",
                "example": [
                  "12345"
                ],
                "items": {
                  "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
                  "type": "string"
                },
                "type": "array"
              },
              "projects": {
                "description": "*Create-Only* Array of project gids. In order to change projects on an existing task use `addProject` and `removeProject`.",
                "example": [
                  "12345"
                ],
                "items": {
                  "description": "Gid of a project.",
                  "type": "string"
                },
                "type": "array"
              },
              "tags": {
                "description": "*Create-Only* Array of tag gids. In order to change tags on an existing task use `addTag` and `removeTag`.",
                "example": [
                  "12345"
                ],
                "items": {
                  "description": "Gid of a tag.",
                  "type": "string"
                },
                "type": "array"
              },
              "workspace": {
                "description": "Gid of a workspace.",
                "example": "12345",
                "readOnly": false,
                "type": "string",
                "x-env-variable": true
              }
            },
            "type": "object"
          }
        ]
      },
      "TaskDuplicateRequest": {
        "properties": {
          "include": {
            "description": "A comma-separated list of fields that will be duplicated to the new task.\n##### Fields\n- assignee\n- attachments\n- dates\n- dependencies\n- followers\n- notes\n- parent\n- projects\n- subtasks\n- tags",
            "example": [
              "notes,assignee,subtasks,attachments,tags,followers,projects,dates,dependencies,parent"
            ],
            "pattern": "[notes|assignee|subtasks|attachments|tags|followers|projects|dates|dependencies|parent]",
            "type": "string"
          },
          "name": {
            "description": "The name of the new task.",
            "example": "New Task Name",
            "type": "string"
          }
        },
        "type": "object"
      },
      "TaskMembership": {
        "properties": {
          "project": {
            "$ref": "#/components/schemas/ProjectCompact"
          },
          "section": {
            "allOf": [
              {
                "$ref": "#/components/schemas/SectionCompact"
              },
              {}
            ],
            "nullable": true
          }
        },
        "type": "object"
      },
      "TaskRemoveFollowersRequest": {
        "properties": {
          "followers": {
            "description": "An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user.",
            "example": [
              "13579",
              "321654"
            ],
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "followers"
        ],
        "type": "object"
      },
      "TaskRemoveProjectRequest": {
        "properties": {
          "project": {
            "description": "The project to remove the task from.",
            "example": "13579",
            "type": "string"
          }
        },
        "required": [
          "project"
        ],
        "type": "object"
      },
      "TaskRemoveTagRequest": {
        "properties": {
          "tag": {
            "description": "The tag's gid to remove from the task.",
            "example": "13579",
            "type": "string"
          }
        },
        "required": [
          "tag"
        ],
        "type": "object"
      },
      "TaskRequestBase": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TaskBase"
          },
          {
            "properties": {
              "assignee": {
                "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
                "example": "12345",
                "nullable": true,
                "readOnly": false,
                "type": "string",
                "x-env-variable": true
              },
              "assignee_section": {
                "description": "The *assignee section* is a subdivision of a project that groups tasks together in the assignee's \"My tasks\" list. It can either be a header above a list of tasks in a list view or a column in a board view of \"My tasks.\"\nThe `assignee_section` property will be returned in the response only if the request was sent by the user who is the assignee of the task. Note that you can only write to `assignee_section` with the gid of an existing section visible in the user's \"My tasks\" list.",
                "example": "12345",
                "nullable": true,
                "type": "string"
              },
              "custom_fields": {
                "additionalProperties": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "number"
                    },
                    {
                      "type": "object"
                    },
                    {
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    }
                  ],
                  "description": "\"{custom_field_gid}\" => Value (can be text, a number, etc.). For date, use format \"YYYY-MM-DD\" (e.g., 2019-09-15). For date-time, use ISO 8601 date string in UTC (e.g., 2019-09-15T02:06:58.147Z).",
                  "nullable": true
                },
                "description": "An object where each key is the GID of a custom field and its corresponding value is either an enum GID, string, number, object, or array (depending on the custom field type). See the [custom fields guide](/docs/custom-fields-guide) for details on creating and updating custom field values.",
                "example": {
                  "4578152156": "Not Started",
                  "5678904321": "On Hold"
                },
                "type": "object"
              },
              "custom_type": {
                "description": "*Conditional:* You can only set custom_type if task `resource_subtype` is `custom`. GID or globally-unique identifier of a task's custom type. The type must be valid for tasks, and some Asana-created custom types cannot be assigned via the API; attempting either returns an error explaining which condition failed.",
                "example": "12345",
                "nullable": true,
                "readOnly": false,
                "type": "string",
                "x-env-variable": true
              },
              "custom_type_status_option": {
                "description": "*Conditional:* You can only set custom_type_status_option if task `resource_subtype` is `custom` GID or globally-unique identifier of a custom type's status option.",
                "example": "12345",
                "nullable": true,
                "readOnly": false,
                "type": "string",
                "x-env-variable": true
              },
              "html_custom_fields": {
                "additionalProperties": {
                  "description": "\"{custom_field_gid}\" => HTML string (e.g., \"<body>Text content</body>\")",
                  "type": "string"
                },
                "description": "An object where each key is the GID of a text custom field and the corresponding value is a rich text HTML string. Only text-type custom fields support this parameter. Values must be wrapped in <body></body> tags. See the [custom fields guide](/docs/custom-fields-guide) and [rich text](/docs/rich-text) for details on supported formatting.",
                "example": {
                  "4578152156": "<body><code>Code block</code></body>",
                  "5678904321": "<body><strong>Bold text</strong></body>"
                },
                "type": "object"
              },
              "parent": {
                "description": "Gid of a task.",
                "example": "12345",
                "nullable": true,
                "readOnly": false,
                "type": "string",
                "x-env-variable": true
              }
            },
            "type": "object"
          }
        ]
      },
      "TaskResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TaskBase"
          },
          {
            "properties": {
              "assignee": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/UserCompact"
                  },
                  {}
                ],
                "nullable": true
              },
              "assignee_section": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/SectionCompact"
                  },
                  {
                    "description": "The *assignee section* is a subdivision of a project that groups tasks together in the assignee's \"My tasks\" list. It can either be a header above a list of tasks in a list view or a column in a board view of \"My tasks.\"\nThe `assignee_section` property will be returned in the response only if the request was sent by the user who is the assignee of the task. Note that you can only write to `assignee_section` with the gid of an existing section visible in the user's \"My tasks\" list.",
                    "type": "object"
                  }
                ],
                "nullable": true
              },
              "custom_fields": {
                "description": "Array of custom field values applied to the task. These represent the custom field values recorded on this project for a particular custom field. For example, these custom field values will contain an `enum_value` property for custom fields of type `enum`, a `text_value` property for custom fields of type `text`, and so on. Please note that the `gid` returned on each custom field value *is identical* to the `gid` of the custom field, which allows referencing the custom field metadata through the `/custom_fields/custom_field_gid` endpoint. The array includes custom fields from projects the task belongs to directly and from projects inherited from its full ancestor chain.",
                "items": {
                  "$ref": "#/components/schemas/CustomFieldResponse"
                },
                "readOnly": true,
                "type": "array"
              },
              "custom_type": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/CustomTypeCompact"
                  },
                  {}
                ],
                "nullable": true
              },
              "custom_type_status_option": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/CustomTypeStatusOptionCompact"
                  },
                  {}
                ],
                "nullable": true
              },
              "effective_memberships": {
                "description": "<p><strong style={{ color: \"#4573D2\" }}>Full object requires scope: </strong><code>projects:read</code>, <code>project_sections:read</code></p>\n\nOpt-in, read-only. The union of direct and inherited memberships for this task. If the task is both directly associated with and inherits the same project, the direct membership takes precedence.",
                "items": {
                  "$ref": "#/components/schemas/EffectiveTaskMembership"
                },
                "readOnly": true,
                "type": "array"
              },
              "followers": {
                "description": "Array of users following this task.",
                "items": {
                  "$ref": "#/components/schemas/UserCompact"
                },
                "readOnly": true,
                "type": "array"
              },
              "parent": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TaskCompact"
                  },
                  {
                    "description": "The parent of this task, or `null` if this is not a subtask. This property cannot be modified using a PUT request but you can change it with the `setParent` endpoint. You can create subtasks by using the subtasks endpoint.",
                    "readOnly": true,
                    "type": "object"
                  }
                ],
                "nullable": true
              },
              "permalink_url": {
                "description": "A url that points directly to the object within Asana.",
                "example": "https://app.asana.com/1/12345/task/123456789",
                "readOnly": true,
                "type": "string"
              },
              "projects": {
                "description": "*Create-only.* Array of projects this task is directly associated with. At task creation time, this array can be used to add the task to many projects at once. After task creation, these associations can be modified using the addProject and removeProject endpoints.",
                "items": {
                  "$ref": "#/components/schemas/ProjectCompact"
                },
                "readOnly": true,
                "type": "array"
              },
              "tags": {
                "description": "Array of tags associated with this task. In order to change tags on an existing task use `addTag` and `removeTag`.",
                "example": [
                  {
                    "gid": "59746",
                    "name": "Grade A"
                  }
                ],
                "items": {
                  "$ref": "#/components/schemas/TagCompact"
                },
                "readOnly": true,
                "type": "array"
              },
              "workspace": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/WorkspaceCompact"
                  },
                  {
                    "description": "*Create-only*. The workspace this task is associated with. Once created, task cannot be moved to a different workspace. This attribute can only be specified at creation time.",
                    "readOnly": true,
                    "type": "object"
                  }
                ]
              }
            },
            "type": "object"
          }
        ]
      },
      "TaskSetParentRequest": {
        "properties": {
          "insert_after": {
            "description": "A subtask of the parent to insert the task after, or `null` to insert at the beginning of the list.",
            "example": "null",
            "nullable": true,
            "type": "string"
          },
          "insert_before": {
            "description": "A subtask of the parent to insert the task before, or `null` to insert at the end of the list.",
            "example": "124816",
            "nullable": true,
            "type": "string"
          },
          "parent": {
            "description": "The new parent of the task, or `null` for no parent.",
            "example": "987654",
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "parent"
        ],
        "type": "object"
      },
      "TaskStoryCreateRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/StoryRequest"
          },
          {
            "properties": {
              "parent_comment": {
                "description": "The GID of the top-level comment envelope to reply to, exposed as `comment_gid` on story reads. This is not the story `gid`. Retrieve it with `GET /stories/{story_gid}?opt_fields=comment_gid`. The parent must belong to the task in the request URL and must not itself be a reply. Works with either `text` or `html_text`. Omit this input to create a top-level comment.",
                "example": "12345",
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "TaskTemplateBase": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TaskTemplateCompact"
          }
        ]
      },
      "TaskTemplateCompact": {
        "description": "A *task template* is an object that allows new tasks to be created with a predefined setup.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "Name of the task template.",
            "example": "Packing list",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task_template",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "TaskTemplateInstantiateTaskRequest": {
        "properties": {
          "name": {
            "description": "The name of the new task. If not provided, the name of the task template will be used.",
            "example": "New Task",
            "type": "string"
          }
        },
        "type": "object"
      },
      "TaskTemplateRecipe": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TaskTemplateRecipeCompact"
          },
          {
            "properties": {
              "attachments": {
                "description": "Array of attachments that will be added to the task created from this template",
                "items": {
                  "$ref": "#/components/schemas/AttachmentCompact"
                },
                "type": "array"
              },
              "custom_fields": {
                "description": "Array of custom fields that will be added to the task created from this template",
                "items": {
                  "$ref": "#/components/schemas/CustomFieldCompact"
                },
                "type": "array"
              },
              "dependencies": {
                "description": "Array of task templates that the task created from this template will depend on",
                "items": {
                  "$ref": "#/components/schemas/TaskTemplateRecipeCompact"
                },
                "type": "array"
              },
              "dependents": {
                "description": "Array of task templates that will depend on the task created from this template",
                "items": {
                  "$ref": "#/components/schemas/TaskTemplateRecipeCompact"
                },
                "type": "array"
              },
              "description": {
                "description": "Description of the task that will be created from this template.",
                "example": "Please describe the bug you found and how to reproduce it.",
                "type": "string"
              },
              "due_time": {
                "description": "The time of day that the task will be due",
                "example": "13:15:00.000Z",
                "nullable": true,
                "type": "string"
              },
              "followers": {
                "description": "Array of users that will be added as followers to the task created from this template",
                "items": {
                  "$ref": "#/components/schemas/UserCompact"
                },
                "type": "array"
              },
              "html_description": {
                "description": "HTML description of the task that will be created from this template. See [rich text](/docs/rich-text#reading-rich-text).",
                "example": "Please describe the bug you found and how to reproduce it.",
                "type": "string"
              },
              "memberships": {
                "description": "Array of projects that the task created from this template will be added to",
                "items": {
                  "$ref": "#/components/schemas/ProjectCompact"
                },
                "type": "array"
              },
              "relative_due_on": {
                "description": "The number of days after the task has been instantiated on which that the task will be due",
                "example": 2,
                "nullable": true,
                "type": "integer"
              },
              "relative_start_on": {
                "description": "The number of days after the task has been instantiated on which that the task will start",
                "example": 1,
                "nullable": true,
                "type": "integer"
              },
              "subtasks": {
                "description": "Array of subtasks that will be added to the task created from this template",
                "items": {
                  "$ref": "#/components/schemas/TaskTemplateRecipeCompact"
                },
                "type": "array"
              }
            },
            "type": "object"
          }
        ]
      },
      "TaskTemplateRecipeCompact": {
        "properties": {
          "name": {
            "description": "Name of the task that will be created from this template.",
            "example": "Bug Report",
            "type": "string"
          },
          "task_resource_subtype": {
            "description": "The subtype of the task that will be created from this template.",
            "enum": [
              "default_task",
              "milestone_task",
              "approval_task"
            ],
            "example": "default_task",
            "type": "string"
          }
        },
        "type": "object"
      },
      "TaskTemplateResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TaskTemplateBase"
          },
          {
            "properties": {
              "created_at": {
                "description": "The time at which this task template was created.",
                "example": "2019-01-01T00:00:00.000Z",
                "format": "date-time",
                "type": "string"
              },
              "created_by": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/UserCompact"
                  }
                ],
                "description": "The user who created this task template."
              },
              "name": {
                "description": "Name of the task template.",
                "example": "Bug Report Template",
                "type": "string"
              },
              "project": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ProjectCompact"
                  }
                ],
                "description": "The project that this task template belongs to.",
                "nullable": true
              },
              "template": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TaskTemplateRecipe"
                  }
                ],
                "description": "The configuration for the task that will be created from this template."
              }
            },
            "type": "object"
          }
        ]
      },
      "TaskUpdateRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TaskRequestBase"
          }
        ]
      },
      "TeamAddUserRequest": {
        "description": "A user identification object for specification with the addUser/removeUser endpoints.",
        "properties": {
          "user": {
            "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
            "example": "12345",
            "type": "string"
          }
        },
        "type": "object"
      },
      "TeamBase": {
        "$ref": "#/components/schemas/TeamCompact"
      },
      "TeamCompact": {
        "description": "<p><strong style={{ color: \"#4573D2\" }}>Full object requires scope: </strong><code>teams:read</code></p>\n\nA *team* is used to group related projects and people together within an organization. Each project in an organization is associated with a team.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the team.",
            "example": "Marketing",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "team",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "TeamMembershipBase": {
        "$ref": "#/components/schemas/TeamMembershipCompact"
      },
      "TeamMembershipCompact": {
        "description": "This object represents a user's connection to a team.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "is_admin": {
            "description": "Describes if the user is a team admin.",
            "example": false,
            "type": "boolean"
          },
          "is_guest": {
            "description": "Describes if the user is a guest in the team.",
            "example": false,
            "type": "boolean"
          },
          "is_limited_access": {
            "description": "Describes if the user has limited access to the team.",
            "example": false,
            "readOnly": true,
            "type": "boolean"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "team_membership",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "team": {
            "$ref": "#/components/schemas/TeamCompact"
          },
          "user": {
            "$ref": "#/components/schemas/UserCompact"
          }
        },
        "type": "object"
      },
      "TeamMembershipResponse": {
        "$ref": "#/components/schemas/TeamMembershipBase"
      },
      "TeamRemoveUserRequest": {
        "description": "A user identification object for specification with the addUser/removeUser endpoints.",
        "properties": {
          "user": {
            "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
            "example": "12345",
            "type": "string"
          }
        },
        "type": "object"
      },
      "TeamRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TeamBase"
          },
          {
            "properties": {
              "description": {
                "description": "The description of the team.\n",
                "example": "All developers should be members of this team.",
                "type": "string"
              },
              "edit_team_name_or_description_access_level": {
                "description": "Controls who can edit team name and description\n",
                "enum": [
                  "all_team_members",
                  "only_team_admins"
                ],
                "type": "string"
              },
              "edit_team_visibility_or_trash_team_access_level": {
                "description": "Controls who can edit team visibility and trash teams\n",
                "enum": [
                  "all_team_members",
                  "only_team_admins"
                ],
                "type": "string"
              },
              "endorsed": {
                "description": "Whether the team has been endorsed\n",
                "example": false,
                "type": "boolean"
              },
              "guest_invite_management_access_level": {
                "description": "Controls who can accept or deny guest invites for a given team\n",
                "enum": [
                  "all_team_members",
                  "only_team_admins"
                ],
                "type": "string"
              },
              "html_description": {
                "description": "The description of the team with formatting as HTML. See [rich text](/docs/rich-text).\n",
                "example": "<body><em>All</em> developers should be members of this team.</body>",
                "type": "string"
              },
              "join_request_management_access_level": {
                "description": "Controls who can accept or deny join team requests for a Membership by Request team. This field can only be updated when the team's `visibility` field is `request_to_join`.\n",
                "enum": [
                  "all_team_members",
                  "only_team_admins"
                ],
                "type": "string"
              },
              "member_invite_management_access_level": {
                "description": "Controls who can accept or deny member invites for a given team\n",
                "enum": [
                  "all_team_members",
                  "only_team_admins"
                ],
                "type": "string"
              },
              "organization": {
                "description": "The organization/workspace the team belongs to. This must be the same organization you are in and cannot be changed once set.\n",
                "example": "123456789",
                "type": "string"
              },
              "team_content_management_access_level": {
                "description": "Controls who can create and share content with the team\n",
                "enum": [
                  "no_restriction",
                  "only_team_admins"
                ],
                "type": "string"
              },
              "team_member_removal_access_level": {
                "description": "Controls who can remove team members\n",
                "enum": [
                  "all_team_members",
                  "only_team_admins"
                ],
                "type": "string"
              },
              "visibility": {
                "description": "The visibility of the team to users in the same organization\n",
                "enum": [
                  "secret",
                  "request_to_join",
                  "public"
                ],
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "TeamResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TeamBase"
          },
          {
            "properties": {
              "custom_field_settings": {
                "description": "Array of Custom Field Settings applied to the team.",
                "items": {
                  "$ref": "#/components/schemas/CustomFieldSettingResponse"
                },
                "type": "array"
              },
              "description": {
                "description": "[Opt In](/docs/inputoutput-options). The description of the team.\n",
                "example": "All developers should be members of this team.",
                "type": "string"
              },
              "edit_team_name_or_description_access_level": {
                "description": "Controls who can edit team name and description\n",
                "enum": [
                  "all_team_members",
                  "only_team_admins"
                ],
                "type": "string"
              },
              "edit_team_visibility_or_trash_team_access_level": {
                "description": "Controls who can edit team visibility and trash teams\n",
                "enum": [
                  "all_team_members",
                  "only_team_admins"
                ],
                "type": "string"
              },
              "endorsed": {
                "description": "Whether the team has been endorsed\n",
                "example": false,
                "type": "boolean"
              },
              "guest_invite_management_access_level": {
                "description": "Controls who can accept or deny guest invites for a given team\n",
                "enum": [
                  "all_team_members",
                  "only_team_admins"
                ],
                "type": "string"
              },
              "html_description": {
                "description": "[Opt In](/docs/inputoutput-options). The description of the team with formatting as HTML. See [rich text](/docs/rich-text#reading-rich-text).\n",
                "example": "<body><em>All</em> developers should be members of this team.</body>",
                "type": "string"
              },
              "join_request_management_access_level": {
                "description": "Controls who can accept or deny join team requests for a Membership by Request team. This field can only be updated when the team's `visibility` field is `request_to_join`.\n",
                "enum": [
                  "all_team_members",
                  "only_team_admins"
                ],
                "type": "string"
              },
              "member_invite_management_access_level": {
                "description": "Controls who can accept or deny member invites for a given team\n",
                "enum": [
                  "all_team_members",
                  "only_team_admins"
                ],
                "type": "string"
              },
              "organization": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/WorkspaceCompact"
                  },
                  {
                    "description": "The organization/workspace the team belongs to.\n",
                    "type": "object"
                  }
                ]
              },
              "permalink_url": {
                "description": "A url that points directly to the object within Asana.",
                "example": "https://app.asana.com/0/resource/123456789/list",
                "readOnly": true,
                "type": "string"
              },
              "team_content_management_access_level": {
                "description": "Controls who can create and share content with the team\n",
                "enum": [
                  "no_restriction",
                  "only_team_admins"
                ],
                "type": "string"
              },
              "team_member_removal_access_level": {
                "description": "Controls who can remove team members\n",
                "enum": [
                  "all_team_members",
                  "only_team_admins"
                ],
                "type": "string"
              },
              "visibility": {
                "description": "The visibility of the team to users in the same organization\n",
                "enum": [
                  "secret",
                  "request_to_join",
                  "public"
                ],
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "TemplateRole": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "Name of the template role.",
            "example": "Designer",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "TimePeriodBase": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TimePeriodCompact"
          },
          {
            "properties": {
              "parent": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TimePeriodCompact"
                  },
                  {}
                ],
                "nullable": true
              }
            },
            "type": "object"
          }
        ]
      },
      "TimePeriodCompact": {
        "description": "<p><strong style={{ color: \"#4573D2\" }}>Full object requires scope: </strong><code>time_periods:read</code></p>\n\nA generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "display_name": {
            "description": "A string representing the cadence code and the fiscal year.",
            "example": "Q1 FY22",
            "type": "string"
          },
          "end_on": {
            "description": "The localized end date of the time period in `YYYY-MM-DD` format.",
            "example": "2019-09-14",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "period": {
            "description": "The cadence and index of the time period.",
            "enum": [
              "FY",
              "H1",
              "H2",
              "Q1",
              "Q2",
              "Q3",
              "Q4"
            ],
            "example": "Q1",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "time_period",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_on": {
            "description": "The localized start date of the time period in `YYYY-MM-DD` format.",
            "example": "2019-09-13",
            "type": "string"
          }
        },
        "type": "object"
      },
      "TimePeriodResponse": {
        "$ref": "#/components/schemas/TimePeriodBase"
      },
      "TimeTrackingCategoryBaseRequest": {
        "properties": {
          "color": {
            "description": "The color associated with this category for display purposes.",
            "enum": [
              "none",
              "red",
              "orange",
              "yellow-orange",
              "yellow",
              "yellow-green",
              "green",
              "blue-green",
              "aqua",
              "blue",
              "indigo",
              "purple",
              "magenta",
              "hot-pink",
              "pink",
              "cool-gray"
            ],
            "example": "blue",
            "type": "string"
          },
          "name": {
            "description": "The name of the time tracking category (e.g., 'Development', 'Meetings').",
            "example": "Development",
            "type": "string"
          }
        },
        "type": "object"
      },
      "TimeTrackingCategoryCompact": {
        "description": "A *time tracking category* is a label that can be assigned to time tracking entries. Categories are workspace-scoped and allow users to classify logged time (e.g., 'Development', 'Meetings').",
        "properties": {
          "color": {
            "description": "The color associated with this category for display purposes.",
            "enum": [
              "none",
              "red",
              "orange",
              "yellow-orange",
              "yellow",
              "yellow-green",
              "green",
              "blue-green",
              "aqua",
              "blue",
              "indigo",
              "purple",
              "magenta",
              "hot-pink",
              "pink",
              "cool-gray"
            ],
            "example": "blue",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the time tracking category.",
            "example": "Development",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "time_tracking_category",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "TimeTrackingCategoryCreateRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TimeTrackingCategoryBaseRequest"
          },
          {
            "properties": {
              "workspace": {
                "description": "Globally unique identifier for the workspace.",
                "example": "12345",
                "type": "string"
              }
            },
            "required": [
              "workspace",
              "name"
            ],
            "type": "object"
          }
        ]
      },
      "TimeTrackingCategoryResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TimeTrackingCategoryCompact"
          },
          {
            "properties": {
              "is_archived": {
                "description": "Whether the category is archived. Archived categories cannot be assigned to new time entries but remain visible on existing entries.",
                "example": false,
                "type": "boolean"
              }
            },
            "type": "object"
          }
        ]
      },
      "TimeTrackingCategoryUpdateRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TimeTrackingCategoryBaseRequest"
          },
          {
            "properties": {
              "is_archived": {
                "description": "*Optional*. Whether the category is archived. Archived categories cannot be assigned to new time entries but remain visible on existing entries.",
                "example": false,
                "type": "boolean"
              }
            },
            "type": "object"
          }
        ]
      },
      "TimeTrackingEntryBase": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TimeTrackingEntryCompact"
          },
          {
            "properties": {
              "approval_status": {
                "description": "*Optional*. The current approval status of the entry.",
                "enum": [
                  "DRAFT",
                  "SUBMITTED",
                  "APPROVED",
                  "REJECTED"
                ],
                "example": "DRAFT",
                "readOnly": true,
                "type": "string"
              },
              "billable_status": {
                "description": "*Optional*. The current billable status of the entry.",
                "enum": [
                  "billable",
                  "nonBillable",
                  "notApplicable"
                ],
                "example": "billable",
                "readOnly": true,
                "type": "string"
              },
              "created_at": {
                "description": "The time at which this resource was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "description": {
                "description": "*Optional*. The description of the entry.",
                "example": "My description of work done on this entry",
                "readOnly": true,
                "type": "string"
              },
              "task": {
                "$ref": "#/components/schemas/TaskCompact",
                "readOnly": true
              }
            },
            "type": "object"
          }
        ]
      },
      "TimeTrackingEntryCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "assignee": {
            "allOf": [
              {
                "$ref": "#/components/schemas/UserCompact"
              },
              {
                "description": "The user this entry's logged time is attributed to.",
                "type": "object"
              }
            ]
          },
          "attributable_to": {
            "allOf": [
              {
                "$ref": "#/components/schemas/ProjectCompact"
              },
              {
                "description": "The attributable to project specifies which project's budget a time entry should be counted toward, if the task belongs to more than one project. If it only belongs to one project, it should be that project.",
                "type": "object"
              }
            ]
          },
          "categories": {
            "description": "<p><strong style={{ color: \"#4573D2\" }}>Full object requires scope: </strong><code>time_tracking_categories:read</code></p>\n\nThe categories linked to this time tracking entry.",
            "items": {
              "$ref": "#/components/schemas/TimeTrackingCategoryCompact"
            },
            "readOnly": true,
            "type": "array"
          },
          "created_by": {
            "allOf": [
              {
                "$ref": "#/components/schemas/UserCompact"
              },
              {
                "description": "User that created a time tracking entry.",
                "readOnly": true,
                "type": "object"
              }
            ]
          },
          "duration_minutes": {
            "description": "Time in minutes tracked by the entry.",
            "example": 12,
            "type": "integer"
          },
          "entered_on": {
            "description": "The day that this entry is logged on.",
            "example": "2015-03-14",
            "format": "date",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "time_tracking_entry",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "TimesheetApprovalStatusCompact": {
        "description": "A *timesheet approval status* object represents the approval status for a user's timesheet for a given week. It tracks whether the timesheet is in draft, submitted, approved, or rejected status.",
        "properties": {
          "approval_status": {
            "description": "The current approval status of the timesheet.",
            "enum": [
              "DRAFT",
              "SUBMITTED",
              "APPROVED",
              "REJECTED"
            ],
            "example": "DRAFT",
            "readOnly": true,
            "type": "string"
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "end_date": {
            "description": "The end date of the timesheet week.",
            "example": "2025-01-12",
            "format": "date",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "timesheet_approval_status",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_date": {
            "description": "The start date of the timesheet week.",
            "example": "2025-01-06",
            "format": "date",
            "readOnly": true,
            "type": "string"
          },
          "user": {
            "$ref": "#/components/schemas/UserCompact",
            "description": "The user whose timesheet this approval status is for.",
            "readOnly": true
          },
          "workspace": {
            "$ref": "#/components/schemas/WorkspaceCompact",
            "description": "The workspace in which the timesheet approval status exists.",
            "readOnly": true
          }
        },
        "type": "object"
      },
      "TimesheetApprovalStatusResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TimesheetApprovalStatusCompact"
          },
          {
            "description": "A full *timesheet approval status* object with all available fields.",
            "type": "object"
          }
        ]
      },
      "UpdateTimeTrackingEntryRequest": {
        "properties": {
          "assignee": {
            "description": "*Optional*. The gid of the user which the time is attributed to.",
            "example": "12345",
            "type": "string"
          },
          "attributable_to": {
            "description": "*Optional*. The gid of the project which the time is attributable to.",
            "example": "987654",
            "type": "string"
          },
          "billable_status": {
            "description": "*Optional*. The current billable status of the entry. This field requires the Timesheets and Budgets add-on; including it without the add-on returns a `402 Payment Required` error.",
            "enum": [
              "billable",
              "nonBillable",
              "notApplicable"
            ],
            "example": "billable",
            "type": "string"
          },
          "categories": {
            "description": "*Optional*. The gids of time tracking categories to assign to this time tracking entry. Existing categories will be overridden. Currently limited to a maximum of 1 category. This field requires the Timesheets and Budgets add-on; including it without the add-on returns a `402 Payment Required` error.",
            "example": [
              "12345"
            ],
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "description": {
            "description": "*Optional*. The description of the entry. This field requires the Timesheets and Budgets add-on; including it without the add-on returns a `402 Payment Required` error.",
            "example": "My description of work done on this entry",
            "type": "string"
          },
          "duration_minutes": {
            "description": "*Optional*. Time in minutes tracked by the entry",
            "example": 12,
            "type": "integer"
          },
          "entered_on": {
            "description": "*Optional*. The day that this entry is logged on. Defaults to today if no day specified",
            "example": "2023-03-19",
            "format": "date",
            "type": "string"
          }
        },
        "type": "object"
      },
      "UpdateTimesheetApprovalStatusRequest": {
        "description": "A request to update a timesheet approval status.",
        "properties": {
          "approval_status": {
            "description": "The desired approval status to transition to. Valid transitions depend on the current status of the timesheet approval status.",
            "enum": [
              "submitted",
              "draft",
              "approved",
              "rejected"
            ],
            "example": "submitted",
            "type": "string"
          },
          "message": {
            "description": "Optional message to include with the transition (e.g., reason for approval or rejection).",
            "example": "Approved by manager",
            "type": "string"
          }
        },
        "required": [
          "approval_status"
        ],
        "type": "object"
      },
      "UserBase": {
        "$ref": "#/components/schemas/UserCompact"
      },
      "UserBaseResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/UserBase"
          },
          {
            "properties": {
              "email": {
                "description": "The user's email address.",
                "example": "gsanchez@example.com",
                "format": "email",
                "readOnly": true,
                "type": "string"
              },
              "photo": {
                "description": "A map of the user's profile photo in various sizes, or null if no photo is set. Sizes provided are 21, 27, 36, 60, 128, and 1024. All images are in PNG format, except for 1024 (which is in JPEG format).",
                "example": {
                  "image_1024x1024": "https://...",
                  "image_128x128": "https://...",
                  "image_21x21": "https://...",
                  "image_27x27": "https://...",
                  "image_36x36": "https://...",
                  "image_60x60": "https://..."
                },
                "nullable": true,
                "properties": {
                  "image_1024x1024": {
                    "description": "JPEG image of the user at 1024x1024 pixels.",
                    "format": "uri",
                    "type": "string"
                  },
                  "image_128x128": {
                    "description": "PNG image of the user at 128x128 pixels.",
                    "format": "uri",
                    "type": "string"
                  },
                  "image_21x21": {
                    "description": "PNG image of the user at 21x21 pixels.",
                    "format": "uri",
                    "type": "string"
                  },
                  "image_27x27": {
                    "description": "PNG image of the user at 27x27 pixels.",
                    "format": "uri",
                    "type": "string"
                  },
                  "image_36x36": {
                    "description": "PNG image of the user at 36x36 pixels.",
                    "format": "uri",
                    "type": "string"
                  },
                  "image_60x60": {
                    "description": "PNG image of the user at 60x60 pixels.",
                    "format": "uri",
                    "type": "string"
                  }
                },
                "readOnly": true,
                "type": "object"
              }
            },
            "type": "object"
          }
        ]
      },
      "UserCompact": {
        "description": "A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "*Read-only except when same user as requester*. The user's name.",
            "example": "Greg Sanchez",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "user",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "UserRequest": {
        "$ref": "#/components/schemas/UserBase"
      },
      "UserResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/UserBaseResponse"
          },
          {
            "properties": {
              "custom_fields": {
                "description": "Array of Custom Fields.",
                "items": {
                  "$ref": "#/components/schemas/CustomFieldCompact"
                },
                "type": "array"
              },
              "workspaces": {
                "description": "Workspaces and organizations this user may access.\nNote\\: The API will only return workspaces and organizations that also contain the authenticated user.",
                "items": {
                  "$ref": "#/components/schemas/WorkspaceCompact"
                },
                "readOnly": true,
                "type": "array"
              }
            },
            "type": "object"
          }
        ]
      },
      "UserTaskListBase": {
        "$ref": "#/components/schemas/UserTaskListCompact"
      },
      "UserTaskListCompact": {
        "description": "A user task list represents the tasks assigned to a particular user. It provides API access to a user’s [My tasks](https://asana.com/guide/help/fundamentals/my-tasks) view in Asana.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the user task list.",
            "example": "My tasks in My Workspace",
            "type": "string"
          },
          "owner": {
            "allOf": [
              {
                "$ref": "#/components/schemas/UserCompact"
              }
            ],
            "description": "The owner of the user task list, i.e. the person whose My Tasks is represented by this resource.",
            "readOnly": true
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "user_task_list",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "workspace": {
            "allOf": [
              {
                "$ref": "#/components/schemas/WorkspaceCompact"
              }
            ],
            "description": "The workspace in which the user task list is located.",
            "readOnly": true
          }
        },
        "type": "object"
      },
      "UserTaskListRequest": {
        "$ref": "#/components/schemas/UserTaskListBase"
      },
      "UserTaskListResponse": {
        "$ref": "#/components/schemas/UserTaskListBase"
      },
      "UserUpdateRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/UserRequest"
          },
          {
            "properties": {
              "custom_fields": {
                "additionalProperties": {
                  "description": "\"{custom_field_gid}\" => Value (can be text, enum GID, a number, etc.). For date, use format \"YYYY-MM-DD\" (e.g., 2019-09-15). For date-time, use ISO 8601 date string in UTC (e.g., 2019-09-15T02:06:58.147Z).",
                  "type": "string"
                },
                "description": "An object where each key is the GID of a custom field and its corresponding value is either an enum GID, string, number, or object (depending on the custom field type). See the [custom fields guide](/docs/custom-fields-guide) for details on creating and updating custom field values.",
                "example": {
                  "4578152156": "Not Started",
                  "5678904321": "On Hold"
                },
                "type": "object"
              },
              "html_custom_fields": {
                "additionalProperties": {
                  "description": "\"{custom_field_gid}\" => HTML string (e.g., \"<body>Text content</body>\")",
                  "type": "string"
                },
                "description": "An object where each key is the GID of a text custom field and the corresponding value is a rich text HTML string. Only text-type custom fields support this parameter. Values must be wrapped in <body></body> tags. See the [custom fields guide](/docs/custom-fields-guide) and [rich text](/docs/rich-text) for details on supported formatting.",
                "example": {
                  "4578152156": "<body><code>Code block</code></body>",
                  "5678904321": "<body><strong>Bold text</strong></body>"
                },
                "type": "object"
              }
            },
            "type": "object"
          }
        ]
      },
      "WebhookCompact": {
        "description": "Webhook objects represent the state of an active subscription for a server to be updated with information from Asana. This schema represents the subscription itself, not the objects that are sent to the server. For information on those please refer to the [event](/reference/events) schema.",
        "properties": {
          "active": {
            "description": "If true, the webhook will send events - if false it is considered inactive and will not generate events.",
            "example": false,
            "readOnly": true,
            "type": "boolean"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource": {
            "$ref": "#/components/schemas/AsanaNamedResource"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "webhook",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "target": {
            "description": "The URL to receive the HTTP POST.",
            "example": "https://example.com/receive-webhook/7654",
            "format": "uri",
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "WebhookFilter": {
        "description": "A WebhookFilter can be passed on creation of a webhook in order to filter the types of actions that trigger delivery of an [event](/reference/events)",
        "properties": {
          "action": {
            "description": "The type of change on the **resource** to pass through the filter. For more information refer to `Event.action` in the [event](/reference/events) schema. This can be one of `changed`, `added`, `removed`, `deleted`, and `undeleted` depending on the nature of what has occurred on the resource.",
            "example": "changed",
            "type": "string"
          },
          "fields": {
            "description": "*Conditional.* A whitelist of fields for events which will pass the filter when the resource is changed. These can be any combination of the fields on the resources themselves. This field is only valid for `action` of type `changed`\n*Note: Subscriptions created on higher-level resources such as a Workspace, Team, or Portfolio do not support fields.*",
            "example": [
              "due_at",
              "due_on",
              "dependencies"
            ],
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "resource_subtype": {
            "description": "The resource subtype of the resource that the filter applies to. This should be set to the same value as is returned on the `resource_subtype` field on the resources themselves.",
            "example": "milestone",
            "type": "string"
          },
          "resource_type": {
            "description": "The type of the resource which created the event when modified; for example, to filter to changes on regular tasks this field should be set to `task`.",
            "example": "task",
            "type": "string"
          }
        },
        "type": "object"
      },
      "WebhookRequest": {
        "properties": {
          "filters": {
            "description": "An array of WebhookFilter objects to specify a whitelist of filters to apply to events from this webhook. If a webhook event passes any of the filters the event will be delivered; otherwise no event will be sent to the receiving server.",
            "items": {
              "allOf": [
                {
                  "$ref": "#/components/schemas/WebhookFilter"
                },
                {
                  "description": "A set of filters to specify a whitelist for what types of events will be delivered."
                },
                {
                  "type": "object"
                }
              ]
            },
            "type": "array"
          },
          "resource": {
            "description": "A resource ID to subscribe to. Many Asana resources are valid to create webhooks on, but higher-level resources require filters.",
            "example": "12345",
            "type": "string"
          },
          "target": {
            "description": "The URL to receive the HTTP POST. The full URL will be used to deliver events from this webhook (including parameters) which allows encoding of application-specific state when the webhook is created.",
            "example": "https://example.com/receive-webhook/7654?app_specific_param=app_specific_value",
            "format": "uri",
            "type": "string"
          }
        },
        "required": [
          "resource",
          "target"
        ],
        "type": "object"
      },
      "WebhookResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/WebhookCompact"
          },
          {
            "properties": {
              "created_at": {
                "description": "The time at which this resource was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "delivery_retry_count": {
                "description": "The number of times the webhook has retried delivery of events to the target (resets after a successful attempt).",
                "example": 3,
                "readOnly": true,
                "type": "integer"
              },
              "failure_deletion_timestamp": {
                "description": "The timestamp when the webhook will be deleted if there is no successful attempt to deliver events to the target",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "filters": {
                "description": "Whitelist of filters to apply to events from this webhook. If a webhook event passes any of the filters the event will be delivered; otherwise no event will be sent to the receiving server.",
                "items": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/WebhookFilter"
                    },
                    {
                      "description": "A set of filters to specify a whitelist for what types of events will be delivered."
                    },
                    {
                      "type": "object"
                    }
                  ]
                },
                "type": "array"
              },
              "last_failure_at": {
                "description": "The timestamp when the webhook last received an error when sending an event to the target.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "last_failure_content": {
                "description": "The contents of the last error response sent to the webhook when attempting to deliver events to the target.",
                "example": "500 Server Error\\n\\nCould not complete the request",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "last_success_at": {
                "description": "The timestamp when the webhook last successfully sent an event to the target.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "next_attempt_after": {
                "description": "The timestamp after which the webhook will next attempt to deliver an event to the target.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              }
            },
            "type": "object"
          }
        ]
      },
      "WebhookUpdateRequest": {
        "properties": {
          "filters": {
            "description": "An array of WebhookFilter objects to specify a whitelist of filters to apply to events from this webhook. If a webhook event passes any of the filters the event will be delivered; otherwise no event will be sent to the receiving server.",
            "items": {
              "allOf": [
                {
                  "$ref": "#/components/schemas/WebhookFilter"
                },
                {
                  "description": "A set of filters to specify a whitelist for what types of events will be delivered."
                },
                {
                  "type": "object"
                }
              ]
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "WorkspaceAddUserRequest": {
        "description": "A user identification object for specification with the addUser/removeUser endpoints.",
        "properties": {
          "user": {
            "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
            "example": "12345",
            "type": "string"
          }
        },
        "type": "object"
      },
      "WorkspaceBase": {
        "$ref": "#/components/schemas/WorkspaceCompact"
      },
      "WorkspaceCompact": {
        "description": "A *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the workspace.",
            "example": "My Company Workspace",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "workspace",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "WorkspaceMembershipBase": {
        "$ref": "#/components/schemas/WorkspaceMembershipCompact"
      },
      "WorkspaceMembershipCompact": {
        "description": "This object determines if a user is a member of a workspace.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "workspace_membership",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "user": {
            "$ref": "#/components/schemas/UserCompact"
          },
          "workspace": {
            "$ref": "#/components/schemas/WorkspaceCompact"
          }
        },
        "type": "object"
      },
      "WorkspaceMembershipRequest": {
        "$ref": "#/components/schemas/WorkspaceMembershipBase"
      },
      "WorkspaceMembershipResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/WorkspaceMembershipBase"
          },
          {
            "properties": {
              "created_at": {
                "description": "The time at which this resource was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "is_active": {
                "description": "Indicates whether the user is currently associated with the workspace. Returns `true` for users who have joined the workspace or have been invited but not yet accepted.",
                "readOnly": true,
                "type": "boolean"
              },
              "is_admin": {
                "description": "Reflects if this user is an admin of the workspace.",
                "readOnly": true,
                "type": "boolean"
              },
              "is_guest": {
                "description": "Reflects if this user is a guest of the workspace.",
                "readOnly": true,
                "type": "boolean"
              },
              "is_view_only": {
                "description": "Reflects if this user has view only license in the workspace.",
                "readOnly": true,
                "type": "boolean"
              },
              "user_task_list": {
                "$ref": "#/components/schemas/UserTaskListResponse",
                "description": "The user's \"My tasks\" in the workspace.",
                "readOnly": true
              },
              "vacation_dates": {
                "deprecated": true,
                "description": "*Deprecated:* Use the [`/ooo_entries`](/reference/getoooentries) endpoints instead. Contains keys `start_on` and `end_on` for the vacation dates for the user in this workspace. If `start_on` is null, the entire `vacation_dates` object will be null. If `end_on` is before today, the entire `vacation_dates` object will be null.",
                "nullable": true,
                "properties": {
                  "end_on": {
                    "deprecated": true,
                    "description": "*Deprecated:* Use the [`/ooo_entries`](/reference/getoooentries) endpoints instead. The day on which the user's vacation in this workspace ends, or null if there is no end date. This is a date with `YYYY-MM-DD` format.",
                    "example": "2022-11-07",
                    "nullable": true,
                    "type": "string"
                  },
                  "start_on": {
                    "deprecated": true,
                    "description": "*Deprecated:* Use the [`/ooo_entries`](/reference/getoooentries) endpoints instead. The day on which the user's vacation in this workspace starts. This is a date with `YYYY-MM-DD` format.",
                    "example": "2022-11-05",
                    "type": "string"
                  }
                },
                "readOnly": true,
                "type": "object"
              }
            },
            "type": "object"
          }
        ]
      },
      "WorkspaceRemoveUserRequest": {
        "description": "A user identification object for specification with the addUser/removeUser endpoints.",
        "properties": {
          "user": {
            "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
            "example": "12345",
            "type": "string"
          }
        },
        "type": "object"
      },
      "WorkspaceRequest": {
        "$ref": "#/components/schemas/WorkspaceBase"
      },
      "WorkspaceResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/WorkspaceBase"
          },
          {
            "properties": {
              "email_domains": {
                "description": "The email domains that are associated with this workspace.",
                "example": [
                  "asana.com"
                ],
                "items": {
                  "format": "uri",
                  "type": "string"
                },
                "type": "array"
              },
              "is_organization": {
                "description": "Whether the workspace is an *organization*.",
                "example": false,
                "type": "boolean"
              }
            },
            "type": "object"
          }
        ]
      },
      "sdk__AccessRequestApproveRequest": {
        "description": "A request to approve access for a user.",
        "properties": {
          "access_request_gid": {
            "description": "The ID of the access request that the user is approving.",
            "example": "12345",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__AccessRequestCreateRequest": {
        "description": "A request to create shareable access for a user.",
        "properties": {
          "message": {
            "description": "The optional message to include with the access request. This can be used to provide context or additional information about the request.",
            "example": "I'm looking to request access to this item.",
            "nullable": true,
            "type": "string"
          },
          "target": {
            "description": "The access requestable object that the user is requesting access to. This is the gid of the target. Supports projects and portfolios.",
            "example": "12345",
            "type": "string"
          }
        },
        "required": [
          "target"
        ],
        "type": "object"
      },
      "sdk__AccessRequestRejectRequest": {
        "description": "A request to reject access for a user.",
        "properties": {
          "access_request_gid": {
            "description": "The ID of the access request that the user is rejecting.",
            "example": "12345",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__AccessRequestResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *access request* object represents a request to access a shareable resource within Asana. It includes the requester's information, approval status, and target resource details.",
        "properties": {
          "approval_status": {
            "description": "The current approval status of the request.",
            "enum": [
              "pending",
              "approved",
              "denied"
            ],
            "example": "pending",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "message": {
            "description": "The message included in the access request, if any.",
            "example": "Please grant me access to this resource.",
            "type": "string"
          },
          "requester": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "target": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *target id* object represents the target resource that the requester wants access to.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "access_request"
        }
      },
      "sdk__AccessRequestResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__AccessRequestResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__AccessRequestResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__AccessRequestResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__AccessRequestTargetIdCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *target id* object represents the target resource that the requester wants access to.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "project"
        }
      },
      "sdk__AddCustomFieldSettingRequest": {
        "properties": {
          "custom_field": {
            "oneOf": [
              {
                "description": "The custom field to associate with this container.",
                "example": "14916",
                "type": "string"
              },
              {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.",
                "properties": {
                  "asana_created_field": {
                    "description": "*Conditional*. A unique identifier to associate this field with the template source of truth.",
                    "enum": [
                      "a_v_requirements",
                      "account_name",
                      "actionable",
                      "align_shipping_link",
                      "align_status",
                      "allotted_time",
                      "appointment",
                      "approval_stage",
                      "approved",
                      "article_series",
                      "board_committee",
                      "browser",
                      "campaign_audience",
                      "campaign_project_status",
                      "campaign_regions",
                      "channel_primary",
                      "client_topic_type",
                      "complete_by",
                      "contact",
                      "contact_email_address",
                      "content_channels",
                      "content_channels_needed",
                      "content_stage",
                      "content_type",
                      "contract",
                      "contract_status",
                      "cost",
                      "creation_stage",
                      "creative_channel",
                      "creative_needed",
                      "creative_needs",
                      "data_sensitivity",
                      "deal_size",
                      "delivery_appt",
                      "delivery_appt_date",
                      "department",
                      "department_responsible",
                      "design_request_needed",
                      "design_request_type",
                      "discussion_category",
                      "do_this_task",
                      "editorial_content_status",
                      "editorial_content_tag",
                      "editorial_content_type",
                      "effort",
                      "effort_level",
                      "est_completion_date",
                      "estimated_time",
                      "estimated_value",
                      "expected_cost",
                      "external_steps_needed",
                      "favorite_idea",
                      "feedback_type",
                      "financial",
                      "funding_amount",
                      "grant_application_process",
                      "hiring_candidate_status",
                      "idea_status",
                      "ids_link",
                      "ids_patient_link",
                      "implementation_stage",
                      "insurance",
                      "interview_area",
                      "interview_question_score",
                      "itero_scan_link",
                      "job_s_applied_to",
                      "lab",
                      "launch_status",
                      "lead_status",
                      "localization_language",
                      "localization_market_team",
                      "localization_status",
                      "meeting_minutes",
                      "meeting_needed",
                      "minutes",
                      "mrr",
                      "must_localize",
                      "name_of_foundation",
                      "need_to_follow_up",
                      "next_appointment",
                      "next_steps_sales",
                      "num_people",
                      "number_of_user_reports",
                      "office_location",
                      "onboarding_activity",
                      "owner",
                      "participants_needed",
                      "patient_date_of_birth",
                      "patient_email",
                      "patient_phone",
                      "patient_status",
                      "phone_number",
                      "planning_category",
                      "point_of_contact",
                      "position",
                      "post_format",
                      "prescription",
                      "priority",
                      "priority_level",
                      "product",
                      "product_stage",
                      "progress",
                      "project_size",
                      "project_status",
                      "proposed_budget",
                      "publish_status",
                      "reason_for_scan",
                      "referral",
                      "request_type",
                      "research_status",
                      "responsible_department",
                      "responsible_team",
                      "risk_assessment_status",
                      "room_name",
                      "sales_counterpart",
                      "sentiment",
                      "shipping_link",
                      "social_channels",
                      "stage",
                      "status",
                      "status_design",
                      "status_of_initiative",
                      "system_setup",
                      "task_progress",
                      "team",
                      "team_marketing",
                      "team_responsible",
                      "time_it_takes_to_complete_tasks",
                      "timeframe",
                      "treatment_type",
                      "type_work_requests_it",
                      "use_agency",
                      "user_name",
                      "vendor_category",
                      "vendor_type",
                      "word_count",
                      null
                    ],
                    "example": "priority",
                    "nullable": true,
                    "readOnly": true,
                    "type": "string"
                  },
                  "currency_code": {
                    "description": "ISO 4217 currency code to format this custom field. This will be null if the `format` is not `currency`.",
                    "example": "EUR",
                    "nullable": true,
                    "type": "string"
                  },
                  "custom_label": {
                    "description": "This is the string that appears next to the custom field value. This will be null if the `format` is not `custom`.",
                    "example": "gold pieces",
                    "nullable": true,
                    "type": "string"
                  },
                  "custom_label_position": {
                    "description": "Only relevant for custom fields with `custom` format. This depicts where to place the custom label. This will be null if the `format` is not `custom`.",
                    "enum": [
                      "prefix",
                      "suffix",
                      null
                    ],
                    "example": "suffix",
                    "nullable": true,
                    "type": "string"
                  },
                  "date_value": {
                    "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                    "nullable": true,
                    "properties": {
                      "date": {
                        "description": "A string representing the date in YYYY-MM-DD format.",
                        "example": "2024-08-23",
                        "type": "string"
                      },
                      "date_time": {
                        "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                        "example": "2024-08-23T22:00:00.000Z",
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "description": {
                    "description": "[Opt In](/docs/inputoutput-options). The description of the custom field.",
                    "example": "Development team priority",
                    "type": "string"
                  },
                  "display_value": {
                    "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                    "example": "blue",
                    "nullable": true,
                    "readOnly": true,
                    "type": "string"
                  },
                  "enabled": {
                    "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                    "example": true,
                    "readOnly": true,
                    "type": "boolean"
                  },
                  "enum_options": {
                    "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                    "items": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                      "properties": {
                        "color": {
                          "description": "The color of the enum option. Defaults to `none`.",
                          "example": "blue",
                          "type": "string"
                        },
                        "enabled": {
                          "description": "Whether or not the enum option is a selectable value for the custom field.",
                          "example": true,
                          "type": "boolean"
                        },
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "The name of the enum option.",
                          "example": "Low",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "enum_option"
                      }
                    },
                    "type": "array"
                  },
                  "enum_value": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                    "nullable": true,
                    "properties": {
                      "color": {
                        "description": "The color of the enum option. Defaults to `none`.",
                        "example": "blue",
                        "type": "string"
                      },
                      "enabled": {
                        "description": "Whether or not the enum option is a selectable value for the custom field.",
                        "example": true,
                        "type": "boolean"
                      },
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "The name of the enum option.",
                        "example": "Low",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "enum_option"
                    }
                  },
                  "format": {
                    "description": "The format of this custom field.",
                    "enum": [
                      "currency",
                      "identifier",
                      "percentage",
                      "custom",
                      "duration",
                      "none"
                    ],
                    "example": "custom",
                    "type": "string"
                  },
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "has_notifications_enabled": {
                    "description": "*Conditional*. This flag describes whether a follower of a task with this field should receive inbox notifications from changes to this field.",
                    "example": true,
                    "type": "boolean"
                  },
                  "id_prefix": {
                    "description": "This field is the unique custom ID string for the custom field.",
                    "example": "ID",
                    "nullable": true,
                    "type": "string"
                  },
                  "input_restrictions": {
                    "example": [
                      "task"
                    ],
                    "items": {
                      "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                      "enum": [
                        "task",
                        "project",
                        "portfolio",
                        "goal"
                      ],
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "is_formula_field": {
                    "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                    "example": false,
                    "type": "boolean"
                  },
                  "is_global_to_workspace": {
                    "description": "This flag describes whether this custom field is available to every container in the workspace. Before project-specific custom fields, this field was always true.",
                    "example": true,
                    "readOnly": true,
                    "type": "boolean"
                  },
                  "is_lookup_field": {
                    "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                    "example": false,
                    "type": "boolean"
                  },
                  "multi_enum_values": {
                    "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                    "items": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                      "properties": {
                        "color": {
                          "description": "The color of the enum option. Defaults to `none`.",
                          "example": "blue",
                          "type": "string"
                        },
                        "enabled": {
                          "description": "Whether or not the enum option is a selectable value for the custom field.",
                          "example": true,
                          "type": "boolean"
                        },
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "The name of the enum option.",
                          "example": "Low",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "enum_option"
                      }
                    },
                    "type": "array"
                  },
                  "name": {
                    "description": "The name of the custom field.",
                    "example": "Status",
                    "type": "string"
                  },
                  "number_value": {
                    "description": "*Conditional*. This number is the value of a `number` custom field.",
                    "example": 5.2,
                    "nullable": true,
                    "type": "number"
                  },
                  "owned_by_app": {
                    "description": "*Allow-listed*. Instructs the API that this Custom Field is app-owned. This parameter is allow-listed to specific apps at this point in time. For apps that are not allow-listed, providing this parameter will result in a `403 Forbidden`.",
                    "type": "boolean"
                  },
                  "people_value": {
                    "description": "*Conditional*. Only relevant for custom fields of type `people`. This array of user GIDs, emails, or the string \"me\", reflects the users to be written to a `people` custom field. Note that *write* operations will replace existing users (if any) in the custom field with the users specified in this array.",
                    "example": [
                      "12345"
                    ],
                    "items": {
                      "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "precision": {
                    "description": "Only relevant for custom fields of type `Number`. This field dictates the number of places after the decimal to round to, i.e. 0 is integer values, 1 rounds to the nearest tenth, and so on. Must be between 0 and 6, inclusive.\nFor percentage format, this may be unintuitive, as a value of 0.25 has a precision of 0, while a value of 0.251 has a precision of 1. This is due to 0.25 being displayed as 25%.\nThe identifier format will always have a precision of 0.",
                    "example": 2,
                    "type": "integer"
                  },
                  "reference_value": {
                    "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of GIDs reflects the objects to be written to a `reference` custom field. Note that *write* operations will replace existing objects (if any) in the custom field with the objects specified in this array.",
                    "example": [
                      "12345"
                    ],
                    "items": {
                      "description": "The GID of an object.",
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "representation_type": {
                    "description": "This field tells the type of the custom field.",
                    "enum": [
                      "text",
                      "enum",
                      "multi_enum",
                      "number",
                      "date",
                      "people",
                      "formula",
                      "custom_id",
                      "reference"
                    ],
                    "example": "number",
                    "readOnly": true,
                    "type": "string"
                  },
                  "resource_subtype": {
                    "description": "The type of the custom field. Must be one of the given values.",
                    "enum": [
                      "text",
                      "enum",
                      "multi_enum",
                      "number",
                      "date",
                      "people",
                      "reference"
                    ],
                    "example": "text",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  },
                  "text_value": {
                    "description": "*Conditional*. This string is the value of a `text` custom field.",
                    "example": "Some Value",
                    "nullable": true,
                    "type": "string"
                  },
                  "type": {
                    "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                    "enum": [
                      "text",
                      "enum",
                      "multi_enum",
                      "number",
                      "date",
                      "people",
                      "reference"
                    ],
                    "readOnly": true,
                    "type": "string"
                  },
                  "workspace": {
                    "description": "*Create-Only* The workspace to create a custom field in.",
                    "example": "1331",
                    "type": "string"
                  }
                },
                "required": [
                  "workspace",
                  "resource_subtype"
                ],
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "custom_field"
                }
              }
            ]
          },
          "insert_after": {
            "description": "A gid of a Custom Field Setting on this container, after which the new Custom Field Setting will be added.  `insert_before` and `insert_after` parameters cannot both be specified.",
            "example": "1331",
            "type": "string"
          },
          "insert_before": {
            "description": "A gid of a Custom Field Setting on this container, before which the new Custom Field Setting will be added.  `insert_before` and `insert_after` parameters cannot both be specified.",
            "example": "1331",
            "type": "string"
          },
          "is_important": {
            "description": "Whether this field should be considered important to this container (for instance, to display in the list view of items in the container).",
            "example": true,
            "type": "boolean"
          }
        },
        "required": [
          "custom_field"
        ],
        "type": "object"
      },
      "sdk__AddFollowersRequest": {
        "properties": {
          "followers": {
            "description": "An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user.",
            "example": "521621,621373",
            "type": "string"
          }
        },
        "required": [
          "followers"
        ],
        "type": "object"
      },
      "sdk__AddMembersRequest": {
        "properties": {
          "members": {
            "description": "An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user.",
            "example": "521621,621373",
            "type": "string"
          }
        },
        "required": [
          "members"
        ],
        "type": "object"
      },
      "sdk__AgentCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The display name of the agent.",
            "example": "Developer Blog Writer",
            "readOnly": true,
            "type": "string"
          },
          "resource_subtype": {
            "description": "The subtype of the agent. `asana_teammate` is an Asana-built teammate.",
            "enum": [
              "asana_teammate"
            ],
            "example": "asana_teammate",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "agent"
        }
      },
      "sdk__AgentResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "behavior_guidance": {
            "description": "A description of the agent's behavior.",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "description": {
            "description": "A brief description of what the agent does.",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The display name of the agent.",
            "example": "Developer Blog Writer",
            "readOnly": true,
            "type": "string"
          },
          "photo": {
            "description": "A map of the agent's avatar image in various sizes, or null if no photo is set.",
            "example": {
              "image_1024x1024": "https://...",
              "image_128x128": "https://...",
              "image_21x21": "https://...",
              "image_27x27": "https://...",
              "image_36x36": "https://...",
              "image_60x60": "https://..."
            },
            "nullable": true,
            "properties": {
              "image_1024x1024": {
                "description": "JPEG image at 1024x1024 pixels.",
                "format": "uri",
                "type": "string"
              },
              "image_128x128": {
                "description": "PNG image at 128x128 pixels.",
                "format": "uri",
                "type": "string"
              },
              "image_21x21": {
                "description": "PNG image at 21x21 pixels.",
                "format": "uri",
                "type": "string"
              },
              "image_27x27": {
                "description": "PNG image at 27x27 pixels.",
                "format": "uri",
                "type": "string"
              },
              "image_36x36": {
                "description": "PNG image at 36x36 pixels.",
                "format": "uri",
                "type": "string"
              },
              "image_60x60": {
                "description": "PNG image at 60x60 pixels.",
                "format": "uri",
                "type": "string"
              }
            },
            "readOnly": true,
            "type": "object"
          },
          "resource_subtype": {
            "description": "The subtype of the agent. `asana_teammate` is an Asana-built teammate.",
            "enum": [
              "asana_teammate"
            ],
            "example": "asana_teammate",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "workspace": {
            "allOf": [
              {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the workspace.",
                    "example": "My Company Workspace",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "workspace"
                }
              },
              {
                "type": "object"
              }
            ],
            "description": "The workspace this agent is instantiated within.",
            "readOnly": true
          }
        },
        "required": [
          "workspace"
        ],
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "agent"
        }
      },
      "sdk__AgentResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__AgentResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__AgentResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__AgentResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__AiStudioRunCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA single AI Studio run (rule execution), representing the credits consumed by one execution of an AI Studio rule.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "ai_studio_run"
        }
      },
      "sdk__AiStudioRunResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA single AI Studio run (rule execution), representing the credits consumed by one execution of an AI Studio rule.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA single AI Studio run (rule execution), representing the credits consumed by one execution of an AI Studio rule.\nA single AI Studio run (rule execution). The `gid` is stable and serves as the de-duplication key for incremental loads.",
        "properties": {
          "automation": {
            "description": "The multi-step automation (AutomationWorkflow) the step belonged to when it ran. `null` for standalone rules. Non-null for workflow steps regardless of whether the step itself was later deleted. Each step of a multi-step automation run is returned as its own row with the same `automation`, so group by `automation.gid` to reconstruct per-automation usage. Not dereferenceable yet (no public Automations API).",
            "nullable": true,
            "properties": {
              "gid": {
                "example": "1208222222222222",
                "readOnly": true,
                "type": "string"
              },
              "name": {
                "example": "Intake triage automation",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "example": "automation",
                "readOnly": true,
                "type": "string"
              }
            },
            "readOnly": true,
            "type": "object"
          },
          "credit_source": {
            "description": "Whether the credits were drawn from a paid or free balance.",
            "enum": [
              "paid",
              "free"
            ],
            "readOnly": true,
            "type": "string"
          },
          "credits_used": {
            "description": "The number of credits consumed by the run.",
            "example": 12,
            "readOnly": true,
            "type": "number"
          },
          "division": {
            "description": "The division the actor belonged to at the time of the run, as a compact reference. `null` when division metering is not enabled for the domain. Not dereferenceable yet (no public Division API); `name` reflects the division's current state.",
            "nullable": true,
            "properties": {
              "gid": {
                "example": "1205000000000003",
                "readOnly": true,
                "type": "string"
              },
              "name": {
                "example": "Engineering",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "example": "division",
                "readOnly": true,
                "type": "string"
              }
            },
            "readOnly": true,
            "type": "object"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "model": {
            "description": "The LLM model used for the run.",
            "example": "claude-sonnet-4-6",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "rule": {
            "description": "The rule (AutomationStep) that ran, as a compact reference. Non-null for both standalone rules and multi-step automation steps as long as the step still exists. `null` if the step was deleted after the run. The Rules API is not yet public, so this is not dereferenceable today, but the shape is forward-compatible (consumers can key off `rule.gid`).",
            "nullable": true,
            "properties": {
              "gid": {
                "example": "1208111111111111",
                "readOnly": true,
                "type": "string"
              },
              "name": {
                "example": "Auto-summarize incoming requests",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "example": "rule",
                "readOnly": true,
                "type": "string"
              }
            },
            "readOnly": true,
            "type": "object"
          },
          "rule_owner": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.\nThe user who owns the rule.",
            "properties": {
              "email": {
                "example": "owner@example.com",
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "run_completed_at": {
            "description": "When the run finished. `null` for runs that did not complete (e.g. cancelled). Runs still in progress don't appear in this endpoint (a usage record exists only once a run is metered), so this is non-null for every success/failed run.",
            "example": "2026-05-01T14:03:15.220Z",
            "format": "date-time",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "run_started_at": {
            "description": "When the run was triggered.",
            "example": "2026-05-01T14:03:12.000Z",
            "format": "date-time",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "status": {
            "description": "The outcome of the run.",
            "enum": [
              "success",
              "failed",
              "cancelled"
            ],
            "readOnly": true,
            "type": "string"
          },
          "triggered_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.\nThe user the run executed as, and to whom the credits are attributed. Usually the same as `rule_owner`, but can differ for chained or AI-teammate-triggered runs.",
            "properties": {
              "email": {
                "example": "runner@example.com",
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "triggering_container": {
            "description": "The object the rule lives in (its container) — a project or portfolio — as a compact reference. `null` if the container is unavailable.",
            "nullable": true,
            "properties": {
              "gid": {
                "example": "1206000000000001",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "enum": [
                  "project",
                  "portfolio"
                ],
                "example": "project",
                "readOnly": true,
                "type": "string"
              }
            },
            "readOnly": true,
            "type": "object"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "ai_studio_run"
        }
      },
      "sdk__AiStudioRunResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__AiStudioRunResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__AiStudioSeatCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA single AI Studio seat allocation, representing one user's access to AI Studio in the workspace.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "ai_studio_seat"
        }
      },
      "sdk__AiStudioSeatResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA single AI Studio seat allocation, representing one user's access to AI Studio in the workspace.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA single AI Studio seat allocation, representing one user's access to AI Studio in the workspace.\nA single AI Studio seat allocation (current snapshot).",
        "properties": {
          "assigned_at": {
            "description": "When the seat was granted/assigned.",
            "example": "2026-03-01T00:00:00.000Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "assigned_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.\nThe user who assigned the seat. `null` when assigned by the system.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "license": {
            "description": "The user's effective AI Studio license tier. `/seats` returns only paid seats, so the free tier is not included.",
            "enum": [
              "ai_studio_plus",
              "ai_studio_pro",
              "ai_studio_max"
            ],
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "revoked_at": {
            "description": "When the seat was revoked or expired. `null` for active seats.",
            "format": "date-time",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "state": {
            "description": "The state of the seat.",
            "enum": [
              "active",
              "revoked",
              "expired"
            ],
            "readOnly": true,
            "type": "string"
          },
          "user": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.\nThe user who holds the seat.",
            "properties": {
              "email": {
                "example": "user@example.com",
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "ai_studio_seat"
        }
      },
      "sdk__AiStudioSeatResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__AiStudioSeatResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__AllocationBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "effort": {
            "description": "The amount of time associated with the allocation, represented as a percentage or number of hours.",
            "nullable": true,
            "properties": {
              "type": {
                "description": "The units used for tracking effort on an allocation, either \"hours\" or \"percent\".",
                "enum": [
                  "hours",
                  "percent"
                ],
                "type": "string"
              },
              "value": {
                "description": "The numeric effort value on the allocation.",
                "example": 50,
                "type": "number"
              }
            },
            "type": "object"
          },
          "end_date": {
            "description": "The localized day on which the allocation ends.",
            "example": "2024-02-28",
            "format": "date",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_date": {
            "description": "The localized day on which the allocation starts.",
            "example": "2024-02-28",
            "format": "date",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "allocation"
        }
      },
      "sdk__AllocationRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "assignee": {
            "description": "Globally unique identifier for the user or placeholder assigned to the allocation.",
            "type": "string"
          },
          "effort": {
            "description": "The amount of time associated with the allocation, represented as a percentage or number of hours.",
            "nullable": true,
            "properties": {
              "type": {
                "description": "The units used for tracking effort on an allocation, either \"hours\" or \"percent\".",
                "enum": [
                  "hours",
                  "percent"
                ],
                "type": "string"
              },
              "value": {
                "description": "The numeric effort value on the allocation.",
                "example": 50,
                "type": "number"
              }
            },
            "type": "object"
          },
          "end_date": {
            "description": "The localized day on which the allocation ends.",
            "example": "2024-02-28",
            "format": "date",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "parent": {
            "description": "Globally unique identifier for the project the allocation is on.",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_date": {
            "description": "The localized day on which the allocation starts.",
            "example": "2024-02-28",
            "format": "date",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "allocation"
        }
      },
      "sdk__AllocationResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "assignee": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.\nThe user or placeholder assigned to the allocation.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of allocation resource.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "created_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "effort": {
            "description": "The amount of time associated with the allocation, represented as a percentage or number of hours.",
            "nullable": true,
            "properties": {
              "type": {
                "description": "The units used for tracking effort on an allocation, either \"hours\" or \"percent\".",
                "enum": [
                  "hours",
                  "percent"
                ],
                "type": "string"
              },
              "value": {
                "description": "The numeric effort value on the allocation.",
                "example": 50,
                "type": "number"
              }
            },
            "type": "object"
          },
          "end_date": {
            "description": "The localized day on which the allocation ends.",
            "example": "2024-02-28",
            "format": "date",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          "resource_subtype": {
            "description": "The subtype of the allocation.",
            "example": "project_allocation",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_date": {
            "description": "The localized day on which the allocation starts.",
            "example": "2024-02-28",
            "format": "date",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "allocation"
        }
      },
      "sdk__AllocationResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__AllocationResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__AllocationResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__AllocationResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__AsanaNamedResource": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the object.",
            "example": "Bug Task",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "sdk__AsanaNamedResourceArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__AsanaNamedResource"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__AsanaResource": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "sdk__AttachmentBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nAn *attachment* object represents any file attached to a task in Asana, whether it's an uploaded file or one associated via a third-party service such as Dropbox or Google Drive.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the file.",
            "example": "Screenshot.png",
            "readOnly": true,
            "type": "string"
          },
          "resource_subtype": {
            "description": "The service hosting the attachment. Valid values are `asana`, `dropbox`, `gdrive`, `onedrive`, `box`, `vimeo`, and `external`.",
            "example": "dropbox",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "attachment"
        }
      },
      "sdk__AttachmentCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nAn *attachment* object represents any file attached to a task in Asana, whether it's an uploaded file or one associated via a third-party service such as Dropbox or Google Drive.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the file.",
            "example": "Screenshot.png",
            "readOnly": true,
            "type": "string"
          },
          "resource_subtype": {
            "description": "The service hosting the attachment. Valid values are `asana`, `dropbox`, `gdrive`, `onedrive`, `box`, `vimeo`, and `external`.",
            "example": "dropbox",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "attachment"
        }
      },
      "sdk__AttachmentRequest": {
        "properties": {
          "connect_to_app": {
            "description": "*Optional*. Only relevant for external attachments with a parent task.\nA boolean indicating whether the current app should be connected with\nthe attachment for the purposes of showing an app components widget.\nRequires the app to have been added to a project the parent task is in.\nThis property can only be set if an OAuth token is used to authenticate the request.\n\nCriteria for displaying app widget:\n1. An OAuth token must be used to authenticate the request\n2. The app needs to have its `widget_metadata_url` configured in the developer console\n3. The task the attachment is being attached to must be in a project with the app installed",
            "type": "boolean"
          },
          "file": {
            "description": "Required for `asana` attachments.\n",
            "format": "binary",
            "type": "string"
          },
          "name": {
            "description": "The name of the external resource being attached. Required for attachments of type `external`.\n",
            "type": "string"
          },
          "parent": {
            "description": "Required identifier of the parent task, project, or project_brief, as a string.\n",
            "type": "string"
          },
          "resource_subtype": {
            "description": "The type of the attachment. Must be one of the given values. If not specified, a file attachment of type `asana` will be assumed. Note that if the value of `resource_subtype` is `external`, a `parent`, `name`, and `url` must also be provided.\n",
            "enum": [
              "asana",
              "external"
            ],
            "example": "external",
            "type": "string"
          },
          "url": {
            "description": "The URL of the external resource being attached. Required for attachments of type `external`.\n",
            "type": "string"
          }
        },
        "required": [
          "parent"
        ],
        "type": "object"
      },
      "sdk__AttachmentResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nAn *attachment* object represents any file attached to a task in Asana, whether it's an uploaded file or one associated via a third-party service such as Dropbox or Google Drive.",
        "properties": {
          "connected_to_app": {
            "description": "Whether the attachment is connected to the app making the request for the purposes of showing an app components widget. Only present when the `resource_subtype` is `external` or `gdrive`.",
            "readOnly": true,
            "type": "boolean"
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "download_url": {
            "description": "The URL containing the content of the attachment.\n*Note:* May be null if the attachment is hosted by [Box](https://www.box.com/) and will be null if the attachment is a Video Message hosted by [Vimeo](https://vimeo.com/). If present, this URL may only be valid for two minutes from the time of retrieval. You should avoid persisting this URL somewhere and just refresh it on demand to ensure you do not keep stale URLs.",
            "example": "https://s3.amazonaws.com/assets/1234/Screenshot.png",
            "format": "uri",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "host": {
            "description": "The service hosting the attachment. Valid values are `asana`, `dropbox`, `gdrive`, `onedrive`, `box`, `vimeo`, and `external`.",
            "example": "dropbox",
            "readOnly": true,
            "type": "string"
          },
          "name": {
            "description": "The name of the file.",
            "example": "Screenshot.png",
            "readOnly": true,
            "type": "string"
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe *task* is the basic object around which many operations in Asana are centered.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe *task* is the basic object around which many operations in Asana are centered.\nThe task this attachment is attached to.",
            "nullable": true,
            "properties": {
              "created_by": {
                "description": "[Opt In](/docs/inputoutput-options). A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource.",
                    "example": "1111",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of resource.",
                    "example": "user",
                    "type": "string"
                  }
                },
                "readOnly": true,
                "type": "object"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the task.",
                "example": "Bug Task",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The resource subtype of the parent resource that the filter applies to.",
                "example": "default_task",
                "nullable": true,
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "task"
            }
          },
          "permanent_url": {
            "description": "A stable URL for accessing the attachment through the Asana web application. This URL redirects to the file download location (e.g., an S3 link) if the user is authenticated and authorized to view the parent object (e.g., a task). Unauthorized users will receive a `403 Forbidden` response. This link is persistent and does not expire, but requires an active session to resolve.",
            "example": "https://app.asana.com/app/asana/-/get_asset?asset_id=1234567890",
            "format": "uri",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "resource_subtype": {
            "description": "The service hosting the attachment. Valid values are `asana`, `dropbox`, `gdrive`, `onedrive`, `box`, `vimeo`, and `external`.",
            "example": "dropbox",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "size": {
            "description": "The size of the attachment in bytes. Only present when the `resource_subtype` is `asana`.",
            "example": 12345,
            "readOnly": true,
            "type": "integer"
          },
          "view_url": {
            "description": "The URL where the attachment can be viewed, which may be friendlier to users in a browser than just directing them to a raw file. May be null if no view URL exists for the service.",
            "example": "https://www.dropbox.com/s/123/Screenshot.png",
            "format": "uri",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "attachment"
        }
      },
      "sdk__AttachmentResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__AttachmentResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__AttachmentResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__AttachmentResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__AuditLogEvent": {
        "description": "An object representing a single event within an Asana domain.\n\nEvery audit log event is comprised of an `event_type`, `actor`, `resource`, and `context`. Some events will include additional metadata about the event under `details`. See our [currently supported list of events](/docs/audit-log-events#supported-audit-log-events) for more details.",
        "properties": {
          "actor": {
            "description": "The entity that triggered the event. Will typically be a user.",
            "properties": {
              "actor_type": {
                "description": "The type of actor.\nCan be one of `user`, `asana`, `asana_support`, `anonymous`, `external_administrator`, or `data_retention_policy`.",
                "enum": [
                  "user",
                  "asana",
                  "asana_support",
                  "anonymous",
                  "external_administrator",
                  "data_retention_policy"
                ],
                "example": "user",
                "type": "string"
              },
              "email": {
                "description": "The email of the actor, if it is a user.",
                "example": "gregsanchez@example.com",
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the actor, if it is a user.",
                "example": "1111",
                "type": "string"
              },
              "name": {
                "description": "The name of the actor, if it is a user.",
                "example": "Greg Sanchez",
                "type": "string"
              }
            },
            "type": "object"
          },
          "context": {
            "description": "The context from which this event originated.",
            "properties": {
              "api_authentication_method": {
                "description": "The authentication method used in the context of an API request.\nOnly present if the `context_type` is `api`. Can be one of `cookie`, `oauth`, `personal_access_token`, or `service_account`.",
                "enum": [
                  "cookie",
                  "oauth",
                  "personal_access_token",
                  "service_account"
                ],
                "type": "string"
              },
              "client_ip_address": {
                "description": "The IP address of the client that initiated the event, if applicable.",
                "example": "1.1.1.1",
                "type": "string"
              },
              "context_type": {
                "description": "The type of context.\nCan be one of `web`, `desktop`, `mobile`, `asana_support`, `asana`, `email`, or `api`.",
                "enum": [
                  "web",
                  "desktop",
                  "mobile",
                  "asana_support",
                  "asana",
                  "email",
                  "api"
                ],
                "example": "web",
                "type": "string"
              },
              "oauth_app_name": {
                "description": "The name of the OAuth App that initiated the event.\nOnly present if the `api_authentication_method` is `oauth`.",
                "type": "string"
              },
              "on_behalf_of_user_id": {
                "description": "The ID of the user who requested a change via support.",
                "example": 12345,
                "type": "integer"
              },
              "rule_name": {
                "description": "The name of the automation rule that initiated the event.",
                "example": "When Task is added to this project",
                "type": "string"
              },
              "user_agent": {
                "description": "The user agent of the client that initiated the event, if applicable.",
                "example": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36",
                "type": "string"
              }
            },
            "type": "object"
          },
          "created_at": {
            "description": "The time the event was created.",
            "example": "2021-01-01T00:00:00.000Z",
            "format": "date-time",
            "type": "string"
          },
          "details": {
            "additionalProperties": true,
            "description": "Event specific details. The schema will vary depending on the `event_type`.",
            "properties": {
              "group": {
                "additionalProperties": true,
                "description": "The division or organizational unit where the event occurred. Primarily used to scope role change events (e.g., `user_division_admin_role_changed`), but may appear in other contexts involving group-level changes.",
                "type": "object"
              },
              "new_value": {
                "description": "The new value after the modification in the audited event.",
                "nullable": true,
                "type": "string"
              },
              "old_value": {
                "description": "The previous value of the field that was modified in the audited event.",
                "nullable": true,
                "type": "string"
              },
              "saml_response": {
                "description": "The response received from the IdP when a user logs in with SAML SSO. Present on `user_login_failed` and `user_login_succeeded` events.",
                "nullable": true,
                "type": "string"
              }
            },
            "type": "object"
          },
          "event_category": {
            "description": "The category that this `event_type` belongs to.",
            "example": "deletion",
            "type": "string"
          },
          "event_type": {
            "description": "The type of the event.",
            "example": "task_deleted",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the `AuditLogEvent`, as a string.",
            "example": "12345",
            "type": "string",
            "x-insert-after": false
          },
          "resource": {
            "description": "The primary object that was affected by this event.",
            "properties": {
              "email": {
                "description": "The email of the resource, if applicable.",
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource.",
                "example": "1111",
                "type": "string"
              },
              "name": {
                "description": "The name of the resource.",
                "example": "Example Task",
                "nullable": true,
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of resource. Most resources will not have a subtype.",
                "example": "milestone",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of resource.",
                "example": "task",
                "type": "string"
              }
            },
            "type": "object"
          }
        },
        "type": "object"
      },
      "sdk__AuditLogEventActor": {
        "description": "The entity that triggered the event. Will typically be a user.",
        "properties": {
          "actor_type": {
            "description": "The type of actor.\nCan be one of `user`, `asana`, `asana_support`, `anonymous`, `external_administrator`, or `data_retention_policy`.",
            "enum": [
              "user",
              "asana",
              "asana_support",
              "anonymous",
              "external_administrator",
              "data_retention_policy"
            ],
            "example": "user",
            "type": "string"
          },
          "email": {
            "description": "The email of the actor, if it is a user.",
            "example": "gregsanchez@example.com",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the actor, if it is a user.",
            "example": "1111",
            "type": "string"
          },
          "name": {
            "description": "The name of the actor, if it is a user.",
            "example": "Greg Sanchez",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__AuditLogEventArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__AuditLogEvent"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__AuditLogEventContext": {
        "description": "The context from which this event originated.",
        "properties": {
          "api_authentication_method": {
            "description": "The authentication method used in the context of an API request.\nOnly present if the `context_type` is `api`. Can be one of `cookie`, `oauth`, `personal_access_token`, or `service_account`.",
            "enum": [
              "cookie",
              "oauth",
              "personal_access_token",
              "service_account"
            ],
            "type": "string"
          },
          "client_ip_address": {
            "description": "The IP address of the client that initiated the event, if applicable.",
            "example": "1.1.1.1",
            "type": "string"
          },
          "context_type": {
            "description": "The type of context.\nCan be one of `web`, `desktop`, `mobile`, `asana_support`, `asana`, `email`, or `api`.",
            "enum": [
              "web",
              "desktop",
              "mobile",
              "asana_support",
              "asana",
              "email",
              "api"
            ],
            "example": "web",
            "type": "string"
          },
          "oauth_app_name": {
            "description": "The name of the OAuth App that initiated the event.\nOnly present if the `api_authentication_method` is `oauth`.",
            "type": "string"
          },
          "on_behalf_of_user_id": {
            "description": "The ID of the user who requested a change via support.",
            "example": 12345,
            "type": "integer"
          },
          "rule_name": {
            "description": "The name of the automation rule that initiated the event.",
            "example": "When Task is added to this project",
            "type": "string"
          },
          "user_agent": {
            "description": "The user agent of the client that initiated the event, if applicable.",
            "example": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__AuditLogEventDetails": {
        "additionalProperties": true,
        "description": "Event specific details. The schema will vary depending on the `event_type`.",
        "properties": {
          "group": {
            "additionalProperties": true,
            "description": "The division or organizational unit where the event occurred. Primarily used to scope role change events (e.g., `user_division_admin_role_changed`), but may appear in other contexts involving group-level changes.",
            "type": "object"
          },
          "new_value": {
            "description": "The new value after the modification in the audited event.",
            "nullable": true,
            "type": "string"
          },
          "old_value": {
            "description": "The previous value of the field that was modified in the audited event.",
            "nullable": true,
            "type": "string"
          },
          "saml_response": {
            "description": "The response received from the IdP when a user logs in with SAML SSO. Present on `user_login_failed` and `user_login_succeeded` events.",
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__AuditLogEventResource": {
        "description": "The primary object that was affected by this event.",
        "properties": {
          "email": {
            "description": "The email of the resource, if applicable.",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource.",
            "example": "1111",
            "type": "string"
          },
          "name": {
            "description": "The name of the resource.",
            "example": "Example Task",
            "nullable": true,
            "type": "string"
          },
          "resource_subtype": {
            "description": "The subtype of resource. Most resources will not have a subtype.",
            "example": "milestone",
            "type": "string"
          },
          "resource_type": {
            "description": "The type of resource.",
            "example": "task",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__BatchRequest": {
        "description": "A request object for use in a batch request.",
        "properties": {
          "actions": {
            "items": {
              "description": "An action object for use in a batch request.",
              "properties": {
                "data": {
                  "description": "For `GET` requests, this should be a map of query parameters you would have normally passed in the URL. Options and pagination are not accepted here; put them in `options` instead. For `POST`, `PATCH`, and `PUT` methods, this should be the content you would have normally put in the data field of the body.",
                  "example": {
                    "assignee": "me",
                    "workspace": "1337"
                  },
                  "type": "object"
                },
                "method": {
                  "description": "The HTTP method you wish to emulate for the action.",
                  "enum": [
                    "get",
                    "post",
                    "put",
                    "delete",
                    "patch",
                    "head"
                  ],
                  "example": "get",
                  "type": "string"
                },
                "options": {
                  "description": "Pagination (`limit` and `offset`) and output options (`fields` or `expand`) for the action. “Pretty” JSON output is not an available option on individual actions; if you want pretty output, specify that option on the parent request.",
                  "example": {
                    "fields": [
                      "name",
                      "notes",
                      "completed"
                    ],
                    "limit": 3
                  },
                  "properties": {
                    "fields": {
                      "description": "The fields to retrieve in the request.",
                      "example": [
                        "name",
                        "gid",
                        "notes",
                        "completed"
                      ],
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "limit": {
                      "description": "Pagination limit for the request.",
                      "example": 50,
                      "type": "integer"
                    },
                    "offset": {
                      "description": "Pagination offset for the request.",
                      "example": "eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9",
                      "type": "integer"
                    }
                  },
                  "type": "object"
                },
                "relative_path": {
                  "description": "The path of the desired endpoint relative to the API’s base URL. Query parameters are not accepted here; put them in `data` instead.",
                  "example": "/tasks/123",
                  "type": "string"
                }
              },
              "required": [
                "relative_path",
                "method"
              ],
              "type": "object"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "sdk__BatchRequestAction": {
        "description": "An action object for use in a batch request.",
        "properties": {
          "data": {
            "description": "For `GET` requests, this should be a map of query parameters you would have normally passed in the URL. Options and pagination are not accepted here; put them in `options` instead. For `POST`, `PATCH`, and `PUT` methods, this should be the content you would have normally put in the data field of the body.",
            "example": {
              "assignee": "me",
              "workspace": "1337"
            },
            "type": "object"
          },
          "method": {
            "description": "The HTTP method you wish to emulate for the action.",
            "enum": [
              "get",
              "post",
              "put",
              "delete",
              "patch",
              "head"
            ],
            "example": "get",
            "type": "string"
          },
          "options": {
            "description": "Pagination (`limit` and `offset`) and output options (`fields` or `expand`) for the action. “Pretty” JSON output is not an available option on individual actions; if you want pretty output, specify that option on the parent request.",
            "example": {
              "fields": [
                "name",
                "notes",
                "completed"
              ],
              "limit": 3
            },
            "properties": {
              "fields": {
                "description": "The fields to retrieve in the request.",
                "example": [
                  "name",
                  "gid",
                  "notes",
                  "completed"
                ],
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "limit": {
                "description": "Pagination limit for the request.",
                "example": 50,
                "type": "integer"
              },
              "offset": {
                "description": "Pagination offset for the request.",
                "example": "eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9",
                "type": "integer"
              }
            },
            "type": "object"
          },
          "relative_path": {
            "description": "The path of the desired endpoint relative to the API’s base URL. Query parameters are not accepted here; put them in `data` instead.",
            "example": "/tasks/123",
            "type": "string"
          }
        },
        "required": [
          "relative_path",
          "method"
        ],
        "type": "object"
      },
      "sdk__BatchResponse": {
        "description": "A response object returned from a batch request.",
        "properties": {
          "body": {
            "description": "The JSON body that the invoked endpoint returned.",
            "example": {
              "data": {
                "completed": false,
                "gid": "1967",
                "name": "Hello, world!",
                "notes": "How are you today?"
              }
            },
            "type": "object"
          },
          "headers": {
            "description": "A map of HTTP headers specific to this result. This is primarily used for returning a `Location` header to accompany a `201 Created` result.  The parent HTTP response will contain all common headers.",
            "example": {
              "location": "/tasks/1234"
            },
            "type": "object"
          },
          "status_code": {
            "description": "The HTTP status code that the invoked endpoint returned.",
            "example": 200,
            "type": "integer"
          }
        },
        "type": "object"
      },
      "sdk__BatchResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__BatchResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__BudgetActualRequest": {
        "description": "Defines the configuration of the actual portion of a budget. The actual value represents aggregated time tracking data attributed to the budget’s parent. This object controls which time entries are included based on their billable status. When no entries match the selected filter, the value will be 0.",
        "properties": {
          "billable_status_filter": {
            "description": "Billable status filter applied to time tracking entries contributing to the actual value. Determines which entries are included in aggregation. When not provided, defaults to `billable`.",
            "enum": [
              "billable",
              "non_billable",
              "any"
            ],
            "example": "billable",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__BudgetActualResponse": {
        "description": "Defines the configuration of the actual portion of a budget. The actual value represents aggregated time tracking data attributed to the budget’s parent. This object controls which time entries are included based on their billable status. When no entries match the selected filter, the value will be 0.Defines the configuration of the actual portion of a budget. The actual value represents aggregated time tracking data attributed to the budget’s parent. This object controls which time entries are included based on their billable status. When no entries match the selected filter, the value will be 0.\nRepresents the computed actual portion of a budget. The actual value is derived from time tracking entries attributed to the budget’s parent, filtered according to the specified billable_status_filter. When budget_type is time, it represents minutes; when budget_type is cost, it represents total cost (actual time × resource rate). When no applicable entries exist, value will be 0.",
        "properties": {
          "billable_status_filter": {
            "description": "Billable status filter applied to time tracking entries contributing to the actual value. Determines which entries are included in aggregation. When not provided, defaults to `billable`.",
            "enum": [
              "billable",
              "non_billable",
              "any"
            ],
            "example": "billable",
            "type": "string"
          },
          "units": {
            "description": "The units of the actual value. * When `budget_type` is `time`, units are `\"minutes\"`. * When `budget_type` is `cost`, units are the ISO 4217 currency code configured at the domain level.",
            "example": "USD",
            "readOnly": true,
            "type": "string"
          },
          "value": {
            "description": "The aggregated actual value for the budget. * When `budget_type` is `time`, represents the total actual minutes from time tracking entries. * When `budget_type` is `cost`, represents the total actual cost, computed as (actual time × resource rate).",
            "example": 100,
            "readOnly": true,
            "type": "number"
          }
        },
        "type": "object"
      },
      "sdk__BudgetCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *budget* object represents a budget for a given parent.",
        "properties": {
          "budget_type": {
            "description": "The type of the budget, in \"cost\" or \"time\". The value of this property will dictate how the corresponding values for actual, estimate, and total are interpreted.",
            "enum": [
              "cost",
              "time"
            ],
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "budget"
        }
      },
      "sdk__BudgetEstimateRequest": {
        "description": "Defines how the estimate portion of a budget is configured. This object controls whether the estimate is enabled, what data source it uses, and which tasks (by billable status) are included in calculating the estimate value. When disabled (enabled: false and source: none), the estimate is hidden and the API response will return `value: null` and `units: null` for this field.",
        "properties": {
          "billable_status_filter": {
            "description": "Billable status filter applied to the estimate when `source` is `tasks`. Ignored when `source` is `capacity_plans` or `none`. When not provided, defaults to `billable`.",
            "enum": [
              "billable",
              "non_billable",
              "any"
            ],
            "type": "string"
          },
          "enabled": {
            "description": "Controls whether the estimate is displayed in the budget. This flag primarily affects UI presentation and the response payload. When `false` (and `source` is `none`), the estimate is hidden and the API response will return `value: null` and `units: null` for this field.",
            "example": true,
            "type": "boolean"
          },
          "source": {
            "description": "The data source for the estimate. `tasks`: use task-level estimated time attributed to the parent. `capacity_plans`: use capacity plan estimates attributed to the parent. `none`: disables the estimate; only valid when `enabled` is `false`. When `enabled` is `true`, `source` must not be `none`.",
            "enum": [
              "none",
              "tasks",
              "capacity_plans"
            ],
            "example": "tasks",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__BudgetEstimateResponse": {
        "description": "Defines how the estimate portion of a budget is configured. This object controls whether the estimate is enabled, what data source it uses, and which tasks (by billable status) are included in calculating the estimate value. When disabled (enabled: false and source: none), the estimate is hidden and the API response will return `value: null` and `units: null` for this field.Defines how the estimate portion of a budget is configured. This object controls whether the estimate is enabled, what data source it uses, and which tasks (by billable status) are included in calculating the estimate value. When disabled (enabled: false and source: none), the estimate is hidden and the API response will return `value: null` and `units: null` for this field.\nRepresents the computed estimate portion of a budget. This object includes the calculated estimate value and its corresponding units. The estimate reflects aggregated data from the configured source, and when source is tasks, the specified billable_status_filter determines which tasks contribute. When disabled (enabled: false and source: none), both value and units will be null.",
        "properties": {
          "billable_status_filter": {
            "description": "Billable status filter applied to the estimate when `source` is `tasks`. Ignored when `source` is `capacity_plans` or `none`. When not provided, defaults to `billable`.",
            "enum": [
              "billable",
              "non_billable",
              "any"
            ],
            "type": "string"
          },
          "enabled": {
            "description": "Controls whether the estimate is displayed in the budget. This flag primarily affects UI presentation and the response payload. When `false` (and `source` is `none`), the estimate is hidden and the API response will return `value: null` and `units: null` for this field.",
            "example": true,
            "type": "boolean"
          },
          "source": {
            "description": "The data source for the estimate. `tasks`: use task-level estimated time attributed to the parent. `capacity_plans`: use capacity plan estimates attributed to the parent. `none`: disables the estimate; only valid when `enabled` is `false`. When `enabled` is `true`, `source` must not be `none`.",
            "enum": [
              "none",
              "tasks",
              "capacity_plans"
            ],
            "example": "tasks",
            "type": "string"
          },
          "units": {
            "description": "The units of the estimate value. When `budget_type` is `time`, units are `\"minutes\"`. When `budget_type` is `cost`, units are the ISO 4217 currency code configured at the domain level. When `source` is `none` and `enabled` is `false`, this field will be `null`.",
            "example": "USD",
            "readOnly": true,
            "type": "string"
          },
          "value": {
            "description": "The aggregated estimate value for the budget. This value is computed based on the selected `source` and, when `source` is `tasks`, the specified `billable_status_filter`. When `budget_type` is `time`, represents the aggregated estimated minutes on the parent. When `budget_type` is `cost`, represents the aggregated estimated cost on the parent (estimated time x resource rate). When `source` is `none` and `enabled` is `false`, this field will be `null`.",
            "example": 100,
            "readOnly": true,
            "type": "number"
          }
        },
        "type": "object"
      },
      "sdk__BudgetRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *budget* object represents a budget for a given parent.",
        "properties": {
          "actual": {
            "description": "Defines the configuration of the actual portion of a budget. The actual value represents aggregated time tracking data attributed to the budget’s parent. This object controls which time entries are included based on their billable status. When no entries match the selected filter, the value will be 0.",
            "properties": {
              "billable_status_filter": {
                "description": "Billable status filter applied to time tracking entries contributing to the actual value. Determines which entries are included in aggregation. When not provided, defaults to `billable`.",
                "enum": [
                  "billable",
                  "non_billable",
                  "any"
                ],
                "example": "billable",
                "type": "string"
              }
            },
            "type": "object"
          },
          "budget_type": {
            "description": "The type of the budget, in \"cost\" or \"time\". The value of this property will dictate how the corresponding values for actual, estimate, and total are interpreted.",
            "enum": [
              "cost",
              "time"
            ],
            "type": "string"
          },
          "estimate": {
            "description": "Defines how the estimate portion of a budget is configured. This object controls whether the estimate is enabled, what data source it uses, and which tasks (by billable status) are included in calculating the estimate value. When disabled (enabled: false and source: none), the estimate is hidden and the API response will return `value: null` and `units: null` for this field.",
            "properties": {
              "billable_status_filter": {
                "description": "Billable status filter applied to the estimate when `source` is `tasks`. Ignored when `source` is `capacity_plans` or `none`. When not provided, defaults to `billable`.",
                "enum": [
                  "billable",
                  "non_billable",
                  "any"
                ],
                "type": "string"
              },
              "enabled": {
                "description": "Controls whether the estimate is displayed in the budget. This flag primarily affects UI presentation and the response payload. When `false` (and `source` is `none`), the estimate is hidden and the API response will return `value: null` and `units: null` for this field.",
                "example": true,
                "type": "boolean"
              },
              "source": {
                "description": "The data source for the estimate. `tasks`: use task-level estimated time attributed to the parent. `capacity_plans`: use capacity plan estimates attributed to the parent. `none`: disables the estimate; only valid when `enabled` is `false`. When `enabled` is `true`, `source` must not be `none`.",
                "enum": [
                  "none",
                  "tasks",
                  "capacity_plans"
                ],
                "example": "tasks",
                "type": "string"
              }
            },
            "type": "object"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "parent": {
            "description": "Globally unique ID of the parent object: project. Can only be set on create, immutable thereafter.",
            "example": "181636",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "total": {
            "description": "Defines how the total portion of a budget is configured. The total represents a user-defined target value, not an aggregated one. This object specifies whether the total is displayed and the current value for the selected budget_type.",
            "properties": {
              "enabled": {
                "description": "Indicates whether the total value is active and should be displayed in the budget. This flag primarily affects UI presentation and the response payload.",
                "example": true,
                "type": "boolean"
              },
              "value": {
                "description": "The user-set value for the total budget. When `budget_type` is `time`, represents minutes. When `budget_type` is `cost`, represents the monetary amount in the domain's currency. This value is stored separately for each `budget_type`, so switching between types preserves each value.",
                "example": 100,
                "type": "number"
              }
            },
            "type": "object"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "budget"
        }
      },
      "sdk__BudgetResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *budget* object represents a budget for a given parent.",
        "properties": {
          "actual": {
            "description": "Defines the configuration of the actual portion of a budget. The actual value represents aggregated time tracking data attributed to the budget’s parent. This object controls which time entries are included based on their billable status. When no entries match the selected filter, the value will be 0.Defines the configuration of the actual portion of a budget. The actual value represents aggregated time tracking data attributed to the budget’s parent. This object controls which time entries are included based on their billable status. When no entries match the selected filter, the value will be 0.\nRepresents the computed actual portion of a budget. The actual value is derived from time tracking entries attributed to the budget’s parent, filtered according to the specified billable_status_filter. When budget_type is time, it represents minutes; when budget_type is cost, it represents total cost (actual time × resource rate). When no applicable entries exist, value will be 0.",
            "properties": {
              "billable_status_filter": {
                "description": "Billable status filter applied to time tracking entries contributing to the actual value. Determines which entries are included in aggregation. When not provided, defaults to `billable`.",
                "enum": [
                  "billable",
                  "non_billable",
                  "any"
                ],
                "example": "billable",
                "type": "string"
              },
              "units": {
                "description": "The units of the actual value. * When `budget_type` is `time`, units are `\"minutes\"`. * When `budget_type` is `cost`, units are the ISO 4217 currency code configured at the domain level.",
                "example": "USD",
                "readOnly": true,
                "type": "string"
              },
              "value": {
                "description": "The aggregated actual value for the budget. * When `budget_type` is `time`, represents the total actual minutes from time tracking entries. * When `budget_type` is `cost`, represents the total actual cost, computed as (actual time × resource rate).",
                "example": 100,
                "readOnly": true,
                "type": "number"
              }
            },
            "type": "object"
          },
          "budget_type": {
            "description": "The type of the budget, in \"cost\" or \"time\". The value of this property will dictate how the corresponding values for actual, estimate, and total are interpreted.",
            "enum": [
              "cost",
              "time"
            ],
            "type": "string"
          },
          "estimate": {
            "description": "Defines how the estimate portion of a budget is configured. This object controls whether the estimate is enabled, what data source it uses, and which tasks (by billable status) are included in calculating the estimate value. When disabled (enabled: false and source: none), the estimate is hidden and the API response will return `value: null` and `units: null` for this field.Defines how the estimate portion of a budget is configured. This object controls whether the estimate is enabled, what data source it uses, and which tasks (by billable status) are included in calculating the estimate value. When disabled (enabled: false and source: none), the estimate is hidden and the API response will return `value: null` and `units: null` for this field.\nRepresents the computed estimate portion of a budget. This object includes the calculated estimate value and its corresponding units. The estimate reflects aggregated data from the configured source, and when source is tasks, the specified billable_status_filter determines which tasks contribute. When disabled (enabled: false and source: none), both value and units will be null.",
            "properties": {
              "billable_status_filter": {
                "description": "Billable status filter applied to the estimate when `source` is `tasks`. Ignored when `source` is `capacity_plans` or `none`. When not provided, defaults to `billable`.",
                "enum": [
                  "billable",
                  "non_billable",
                  "any"
                ],
                "type": "string"
              },
              "enabled": {
                "description": "Controls whether the estimate is displayed in the budget. This flag primarily affects UI presentation and the response payload. When `false` (and `source` is `none`), the estimate is hidden and the API response will return `value: null` and `units: null` for this field.",
                "example": true,
                "type": "boolean"
              },
              "source": {
                "description": "The data source for the estimate. `tasks`: use task-level estimated time attributed to the parent. `capacity_plans`: use capacity plan estimates attributed to the parent. `none`: disables the estimate; only valid when `enabled` is `false`. When `enabled` is `true`, `source` must not be `none`.",
                "enum": [
                  "none",
                  "tasks",
                  "capacity_plans"
                ],
                "example": "tasks",
                "type": "string"
              },
              "units": {
                "description": "The units of the estimate value. When `budget_type` is `time`, units are `\"minutes\"`. When `budget_type` is `cost`, units are the ISO 4217 currency code configured at the domain level. When `source` is `none` and `enabled` is `false`, this field will be `null`.",
                "example": "USD",
                "readOnly": true,
                "type": "string"
              },
              "value": {
                "description": "The aggregated estimate value for the budget. This value is computed based on the selected `source` and, when `source` is `tasks`, the specified `billable_status_filter`. When `budget_type` is `time`, represents the aggregated estimated minutes on the parent. When `budget_type` is `cost`, represents the aggregated estimated cost on the parent (estimated time x resource rate). When `source` is `none` and `enabled` is `false`, this field will be `null`.",
                "example": 100,
                "readOnly": true,
                "type": "number"
              }
            },
            "type": "object"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "total": {
            "description": "Defines how the total portion of a budget is configured. The total represents a user-defined target value, not an aggregated one. This object specifies whether the total is displayed and the current value for the selected budget_type.Defines how the total portion of a budget is configured. The total represents a user-defined target value, not an aggregated one. This object specifies whether the total is displayed and the current value for the selected budget_type.\nRepresents the configured total portion of a budget. The total value is user-defined and may differ for each budget_type. When budget_type is time, it is expressed in minutes; when budget_type is cost, it is expressed in the domain’s ISO 4217 currency code. When enabled is false, both value and units will be null.",
            "properties": {
              "enabled": {
                "description": "Indicates whether the total value is active and should be displayed in the budget. This flag primarily affects UI presentation and the response payload.",
                "example": true,
                "type": "boolean"
              },
              "units": {
                "description": "The units of the total value. When `budget_type` is `time`, units are `\"minutes\"`. When `budget_type` is `cost`, units are the ISO 4217 currency code configured at the domain level. When `enabled` is `false`, this field will be `null`.",
                "example": "USD",
                "readOnly": true,
                "type": "string"
              },
              "value": {
                "description": "The user-set value for the total budget. When `budget_type` is `time`, represents minutes. When `budget_type` is `cost`, represents the monetary amount in the domain's currency. This value is stored separately for each `budget_type`, so switching between types preserves each value.",
                "example": 100,
                "type": "number"
              }
            },
            "type": "object"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "budget"
        }
      },
      "sdk__BudgetResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__BudgetResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__BudgetResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__BudgetResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__BudgetTotalRequest": {
        "description": "Defines how the total portion of a budget is configured. The total represents a user-defined target value, not an aggregated one. This object specifies whether the total is displayed and the current value for the selected budget_type.",
        "properties": {
          "enabled": {
            "description": "Indicates whether the total value is active and should be displayed in the budget. This flag primarily affects UI presentation and the response payload.",
            "example": true,
            "type": "boolean"
          },
          "value": {
            "description": "The user-set value for the total budget. When `budget_type` is `time`, represents minutes. When `budget_type` is `cost`, represents the monetary amount in the domain's currency. This value is stored separately for each `budget_type`, so switching between types preserves each value.",
            "example": 100,
            "type": "number"
          }
        },
        "type": "object"
      },
      "sdk__BudgetTotalResponse": {
        "description": "Defines how the total portion of a budget is configured. The total represents a user-defined target value, not an aggregated one. This object specifies whether the total is displayed and the current value for the selected budget_type.Defines how the total portion of a budget is configured. The total represents a user-defined target value, not an aggregated one. This object specifies whether the total is displayed and the current value for the selected budget_type.\nRepresents the configured total portion of a budget. The total value is user-defined and may differ for each budget_type. When budget_type is time, it is expressed in minutes; when budget_type is cost, it is expressed in the domain’s ISO 4217 currency code. When enabled is false, both value and units will be null.",
        "properties": {
          "enabled": {
            "description": "Indicates whether the total value is active and should be displayed in the budget. This flag primarily affects UI presentation and the response payload.",
            "example": true,
            "type": "boolean"
          },
          "units": {
            "description": "The units of the total value. When `budget_type` is `time`, units are `\"minutes\"`. When `budget_type` is `cost`, units are the ISO 4217 currency code configured at the domain level. When `enabled` is `false`, this field will be `null`.",
            "example": "USD",
            "readOnly": true,
            "type": "string"
          },
          "value": {
            "description": "The user-set value for the total budget. When `budget_type` is `time`, represents minutes. When `budget_type` is `cost`, represents the monetary amount in the domain's currency. This value is stored separately for each `budget_type`, so switching between types preserves each value.",
            "example": 100,
            "type": "number"
          }
        },
        "type": "object"
      },
      "sdk__CreateMembershipRequest": {
        "properties": {
          "access_level": {
            "description": "Sets the access level for the member. Goals can have access levels `viewer`, `commenter`, `editor` or `admin`. Projects can have access levels `admin`, `editor` or `commenter`. Portfolios can have access levels `admin`, `editor` or `viewer`. Custom Fields can have access levels `admin`, `editor` or `user`. Tables accept `admin`, `editor`, or `viewer` on creation. Records accept `admin`, `editor`, `commenter`, or `viewer`.",
            "example": "editor",
            "type": "string"
          },
          "member": {
            "description": "The gid of the user or team.",
            "example": 12345,
            "type": "string"
          },
          "parent": {
            "description": "The gid of the `goal`, `project`, `portfolio`, `custom_type`, `custom_field`, `table`, or `record` to add the member to.",
            "example": "987654",
            "type": "string"
          },
          "role": {
            "deprecated": true,
            "description": "*Deprecated: new integrations should use access_level* The role given to the member. Optional argument, will default to `commenter` for goals and the default project role for projects. Can be `editor` or `commenter` for goals. Can be `admin`,`editor` or `commenter` for projects.",
            "example": "editor",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__CreateTimeTrackingEntryRequest": {
        "properties": {
          "assignee": {
            "description": "*Optional*. The gid of the user this entry's logged time is attributed to. Defaults to the current user; can only be set to another user if you're their time reviewer or an admin. Reviewer-submitter relationships require the Timesheets and Budgets add-on.",
            "example": "12345",
            "type": "string"
          },
          "attributable_to": {
            "description": "*Optional*. The gid of the project which the time is attributable to.",
            "example": "987654",
            "type": "string"
          },
          "billable_status": {
            "description": "*Optional*. The current billable status of the entry. This field requires the Timesheets and Budgets add-on; including it without the add-on returns a `402 Payment Required` error.",
            "enum": [
              "billable",
              "nonBillable",
              "notApplicable"
            ],
            "example": "billable",
            "type": "string"
          },
          "categories": {
            "description": "*Optional*. The gids of time tracking categories to assign to this time tracking entry. Existing categories will be overridden. Currently limited to a maximum of 1 category. This field requires the Timesheets and Budgets add-on; including it without the add-on returns a `402 Payment Required` error.",
            "example": [
              "12345"
            ],
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "description": {
            "description": "*Optional*. The description of the entry. This field requires the Timesheets and Budgets add-on; including it without the add-on returns a `402 Payment Required` error.",
            "example": "My description of work done on this entry",
            "type": "string"
          },
          "duration_minutes": {
            "description": "Time in minutes tracked by the entry. Must be greater than 0",
            "example": 12,
            "type": "integer"
          },
          "entered_on": {
            "description": "*Optional*. The day that this entry is logged on. Defaults to today if not specified",
            "example": "2023-03-19",
            "format": "date",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__CreateTimesheetApprovalStatusRequest": {
        "description": "A request to create a timesheet approval status.",
        "properties": {
          "end_date": {
            "description": "The end date of the timesheet week (must be the following Sunday for Monday starts, or the following Saturday for Sunday starts).",
            "example": "2025-01-12",
            "format": "date",
            "type": "string"
          },
          "start_date": {
            "description": "The start date of the timesheet week (must be a Monday or Sunday).",
            "example": "2025-01-06",
            "format": "date",
            "type": "string"
          },
          "user": {
            "description": "Globally unique identifier for the user whose timesheet this is.",
            "example": "12345",
            "type": "string"
          },
          "workspace": {
            "description": "Globally unique identifier for the workspace.",
            "example": "12345",
            "type": "string"
          }
        },
        "required": [
          "user",
          "workspace",
          "start_date",
          "end_date"
        ],
        "type": "object"
      },
      "sdk__CustomFieldBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.",
        "properties": {
          "asana_created_field": {
            "description": "*Conditional*. A unique identifier to associate this field with the template source of truth.",
            "enum": [
              "a_v_requirements",
              "account_name",
              "actionable",
              "align_shipping_link",
              "align_status",
              "allotted_time",
              "appointment",
              "approval_stage",
              "approved",
              "article_series",
              "board_committee",
              "browser",
              "campaign_audience",
              "campaign_project_status",
              "campaign_regions",
              "channel_primary",
              "client_topic_type",
              "complete_by",
              "contact",
              "contact_email_address",
              "content_channels",
              "content_channels_needed",
              "content_stage",
              "content_type",
              "contract",
              "contract_status",
              "cost",
              "creation_stage",
              "creative_channel",
              "creative_needed",
              "creative_needs",
              "data_sensitivity",
              "deal_size",
              "delivery_appt",
              "delivery_appt_date",
              "department",
              "department_responsible",
              "design_request_needed",
              "design_request_type",
              "discussion_category",
              "do_this_task",
              "editorial_content_status",
              "editorial_content_tag",
              "editorial_content_type",
              "effort",
              "effort_level",
              "est_completion_date",
              "estimated_time",
              "estimated_value",
              "expected_cost",
              "external_steps_needed",
              "favorite_idea",
              "feedback_type",
              "financial",
              "funding_amount",
              "grant_application_process",
              "hiring_candidate_status",
              "idea_status",
              "ids_link",
              "ids_patient_link",
              "implementation_stage",
              "insurance",
              "interview_area",
              "interview_question_score",
              "itero_scan_link",
              "job_s_applied_to",
              "lab",
              "launch_status",
              "lead_status",
              "localization_language",
              "localization_market_team",
              "localization_status",
              "meeting_minutes",
              "meeting_needed",
              "minutes",
              "mrr",
              "must_localize",
              "name_of_foundation",
              "need_to_follow_up",
              "next_appointment",
              "next_steps_sales",
              "num_people",
              "number_of_user_reports",
              "office_location",
              "onboarding_activity",
              "owner",
              "participants_needed",
              "patient_date_of_birth",
              "patient_email",
              "patient_phone",
              "patient_status",
              "phone_number",
              "planning_category",
              "point_of_contact",
              "position",
              "post_format",
              "prescription",
              "priority",
              "priority_level",
              "product",
              "product_stage",
              "progress",
              "project_size",
              "project_status",
              "proposed_budget",
              "publish_status",
              "reason_for_scan",
              "referral",
              "request_type",
              "research_status",
              "responsible_department",
              "responsible_team",
              "risk_assessment_status",
              "room_name",
              "sales_counterpart",
              "sentiment",
              "shipping_link",
              "social_channels",
              "stage",
              "status",
              "status_design",
              "status_of_initiative",
              "system_setup",
              "task_progress",
              "team",
              "team_marketing",
              "team_responsible",
              "time_it_takes_to_complete_tasks",
              "timeframe",
              "treatment_type",
              "type_work_requests_it",
              "use_agency",
              "user_name",
              "vendor_category",
              "vendor_type",
              "word_count",
              null
            ],
            "example": "priority",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "currency_code": {
            "description": "ISO 4217 currency code to format this custom field. This will be null if the `format` is not `currency`.",
            "example": "EUR",
            "nullable": true,
            "type": "string"
          },
          "custom_label": {
            "description": "This is the string that appears next to the custom field value. This will be null if the `format` is not `custom`.",
            "example": "gold pieces",
            "nullable": true,
            "type": "string"
          },
          "custom_label_position": {
            "description": "Only relevant for custom fields with `custom` format. This depicts where to place the custom label. This will be null if the `format` is not `custom`.",
            "enum": [
              "prefix",
              "suffix",
              null
            ],
            "example": "suffix",
            "nullable": true,
            "type": "string"
          },
          "date_value": {
            "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
            "nullable": true,
            "properties": {
              "date": {
                "description": "A string representing the date in YYYY-MM-DD format.",
                "example": "2024-08-23",
                "type": "string"
              },
              "date_time": {
                "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                "example": "2024-08-23T22:00:00.000Z",
                "type": "string"
              }
            },
            "type": "object"
          },
          "description": {
            "description": "[Opt In](/docs/inputoutput-options). The description of the custom field.",
            "example": "Development team priority",
            "type": "string"
          },
          "display_value": {
            "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
            "example": "blue",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "enabled": {
            "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
            "example": true,
            "readOnly": true,
            "type": "boolean"
          },
          "enum_options": {
            "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
              "properties": {
                "color": {
                  "description": "The color of the enum option. Defaults to `none`.",
                  "example": "blue",
                  "type": "string"
                },
                "enabled": {
                  "description": "Whether or not the enum option is a selectable value for the custom field.",
                  "example": true,
                  "type": "boolean"
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "The name of the enum option.",
                  "example": "Low",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "enum_option"
              }
            },
            "type": "array"
          },
          "enum_value": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
            "nullable": true,
            "properties": {
              "color": {
                "description": "The color of the enum option. Defaults to `none`.",
                "example": "blue",
                "type": "string"
              },
              "enabled": {
                "description": "Whether or not the enum option is a selectable value for the custom field.",
                "example": true,
                "type": "boolean"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the enum option.",
                "example": "Low",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "enum_option"
            }
          },
          "format": {
            "description": "The format of this custom field.",
            "enum": [
              "currency",
              "identifier",
              "percentage",
              "custom",
              "duration",
              "none"
            ],
            "example": "custom",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "has_notifications_enabled": {
            "description": "*Conditional*. This flag describes whether a follower of a task with this field should receive inbox notifications from changes to this field.",
            "example": true,
            "type": "boolean"
          },
          "id_prefix": {
            "description": "This field is the unique custom ID string for the custom field.",
            "example": "ID",
            "nullable": true,
            "type": "string"
          },
          "input_restrictions": {
            "example": [
              "task"
            ],
            "items": {
              "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
              "enum": [
                "task",
                "project",
                "portfolio",
                "goal"
              ],
              "type": "string"
            },
            "type": "array"
          },
          "is_formula_field": {
            "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
            "example": false,
            "type": "boolean"
          },
          "is_global_to_workspace": {
            "description": "This flag describes whether this custom field is available to every container in the workspace. Before project-specific custom fields, this field was always true.",
            "example": true,
            "readOnly": true,
            "type": "boolean"
          },
          "is_lookup_field": {
            "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
            "example": false,
            "type": "boolean"
          },
          "multi_enum_values": {
            "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
              "properties": {
                "color": {
                  "description": "The color of the enum option. Defaults to `none`.",
                  "example": "blue",
                  "type": "string"
                },
                "enabled": {
                  "description": "Whether or not the enum option is a selectable value for the custom field.",
                  "example": true,
                  "type": "boolean"
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "The name of the enum option.",
                  "example": "Low",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "enum_option"
              }
            },
            "type": "array"
          },
          "name": {
            "description": "The name of the custom field.",
            "example": "Status",
            "type": "string"
          },
          "number_value": {
            "description": "*Conditional*. This number is the value of a `number` custom field.",
            "example": 5.2,
            "nullable": true,
            "type": "number"
          },
          "precision": {
            "description": "Only relevant for custom fields of type `Number`. This field dictates the number of places after the decimal to round to, i.e. 0 is integer values, 1 rounds to the nearest tenth, and so on. Must be between 0 and 6, inclusive.\nFor percentage format, this may be unintuitive, as a value of 0.25 has a precision of 0, while a value of 0.251 has a precision of 1. This is due to 0.25 being displayed as 25%.\nThe identifier format will always have a precision of 0.",
            "example": 2,
            "type": "integer"
          },
          "representation_type": {
            "description": "This field tells the type of the custom field.",
            "enum": [
              "text",
              "enum",
              "multi_enum",
              "number",
              "date",
              "people",
              "formula",
              "custom_id",
              "reference"
            ],
            "example": "number",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "text_value": {
            "description": "*Conditional*. This string is the value of a `text` custom field.",
            "example": "Some Value",
            "nullable": true,
            "type": "string"
          },
          "type": {
            "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
            "enum": [
              "text",
              "enum",
              "multi_enum",
              "number",
              "date",
              "people",
              "reference"
            ],
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "custom_field"
        }
      },
      "sdk__CustomFieldCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.",
        "properties": {
          "date_value": {
            "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
            "nullable": true,
            "properties": {
              "date": {
                "description": "A string representing the date in YYYY-MM-DD format.",
                "example": "2024-08-23",
                "type": "string"
              },
              "date_time": {
                "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                "example": "2024-08-23T22:00:00.000Z",
                "type": "string"
              }
            },
            "type": "object"
          },
          "display_value": {
            "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
            "example": "blue",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "enabled": {
            "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
            "example": true,
            "readOnly": true,
            "type": "boolean"
          },
          "enum_options": {
            "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
              "properties": {
                "color": {
                  "description": "The color of the enum option. Defaults to `none`.",
                  "example": "blue",
                  "type": "string"
                },
                "enabled": {
                  "description": "Whether or not the enum option is a selectable value for the custom field.",
                  "example": true,
                  "type": "boolean"
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "The name of the enum option.",
                  "example": "Low",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "enum_option"
              }
            },
            "type": "array"
          },
          "enum_value": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
            "nullable": true,
            "properties": {
              "color": {
                "description": "The color of the enum option. Defaults to `none`.",
                "example": "blue",
                "type": "string"
              },
              "enabled": {
                "description": "Whether or not the enum option is a selectable value for the custom field.",
                "example": true,
                "type": "boolean"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the enum option.",
                "example": "Low",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "enum_option"
            }
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "id_prefix": {
            "description": "This field is the unique custom ID string for the custom field.",
            "example": "ID",
            "nullable": true,
            "type": "string"
          },
          "input_restrictions": {
            "example": [
              "task"
            ],
            "items": {
              "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
              "enum": [
                "task",
                "project",
                "portfolio",
                "goal"
              ],
              "type": "string"
            },
            "type": "array"
          },
          "is_formula_field": {
            "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
            "example": false,
            "type": "boolean"
          },
          "is_lookup_field": {
            "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
            "example": false,
            "type": "boolean"
          },
          "multi_enum_values": {
            "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
              "properties": {
                "color": {
                  "description": "The color of the enum option. Defaults to `none`.",
                  "example": "blue",
                  "type": "string"
                },
                "enabled": {
                  "description": "Whether or not the enum option is a selectable value for the custom field.",
                  "example": true,
                  "type": "boolean"
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "The name of the enum option.",
                  "example": "Low",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "enum_option"
              }
            },
            "type": "array"
          },
          "name": {
            "description": "The name of the custom field.",
            "example": "Status",
            "type": "string"
          },
          "number_value": {
            "description": "*Conditional*. This number is the value of a `number` custom field.",
            "example": 5.2,
            "nullable": true,
            "type": "number"
          },
          "representation_type": {
            "description": "This field tells the type of the custom field.",
            "enum": [
              "text",
              "enum",
              "multi_enum",
              "number",
              "date",
              "people",
              "formula",
              "custom_id",
              "reference"
            ],
            "example": "number",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "text_value": {
            "description": "*Conditional*. This string is the value of a `text` custom field.",
            "example": "Some Value",
            "nullable": true,
            "type": "string"
          },
          "type": {
            "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
            "enum": [
              "text",
              "enum",
              "multi_enum",
              "number",
              "date",
              "people",
              "reference"
            ],
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "custom_field"
        }
      },
      "sdk__CustomFieldCreateRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.",
        "properties": {
          "asana_created_field": {
            "description": "*Conditional*. A unique identifier to associate this field with the template source of truth.",
            "enum": [
              "a_v_requirements",
              "account_name",
              "actionable",
              "align_shipping_link",
              "align_status",
              "allotted_time",
              "appointment",
              "approval_stage",
              "approved",
              "article_series",
              "board_committee",
              "browser",
              "campaign_audience",
              "campaign_project_status",
              "campaign_regions",
              "channel_primary",
              "client_topic_type",
              "complete_by",
              "contact",
              "contact_email_address",
              "content_channels",
              "content_channels_needed",
              "content_stage",
              "content_type",
              "contract",
              "contract_status",
              "cost",
              "creation_stage",
              "creative_channel",
              "creative_needed",
              "creative_needs",
              "data_sensitivity",
              "deal_size",
              "delivery_appt",
              "delivery_appt_date",
              "department",
              "department_responsible",
              "design_request_needed",
              "design_request_type",
              "discussion_category",
              "do_this_task",
              "editorial_content_status",
              "editorial_content_tag",
              "editorial_content_type",
              "effort",
              "effort_level",
              "est_completion_date",
              "estimated_time",
              "estimated_value",
              "expected_cost",
              "external_steps_needed",
              "favorite_idea",
              "feedback_type",
              "financial",
              "funding_amount",
              "grant_application_process",
              "hiring_candidate_status",
              "idea_status",
              "ids_link",
              "ids_patient_link",
              "implementation_stage",
              "insurance",
              "interview_area",
              "interview_question_score",
              "itero_scan_link",
              "job_s_applied_to",
              "lab",
              "launch_status",
              "lead_status",
              "localization_language",
              "localization_market_team",
              "localization_status",
              "meeting_minutes",
              "meeting_needed",
              "minutes",
              "mrr",
              "must_localize",
              "name_of_foundation",
              "need_to_follow_up",
              "next_appointment",
              "next_steps_sales",
              "num_people",
              "number_of_user_reports",
              "office_location",
              "onboarding_activity",
              "owner",
              "participants_needed",
              "patient_date_of_birth",
              "patient_email",
              "patient_phone",
              "patient_status",
              "phone_number",
              "planning_category",
              "point_of_contact",
              "position",
              "post_format",
              "prescription",
              "priority",
              "priority_level",
              "product",
              "product_stage",
              "progress",
              "project_size",
              "project_status",
              "proposed_budget",
              "publish_status",
              "reason_for_scan",
              "referral",
              "request_type",
              "research_status",
              "responsible_department",
              "responsible_team",
              "risk_assessment_status",
              "room_name",
              "sales_counterpart",
              "sentiment",
              "shipping_link",
              "social_channels",
              "stage",
              "status",
              "status_design",
              "status_of_initiative",
              "system_setup",
              "task_progress",
              "team",
              "team_marketing",
              "team_responsible",
              "time_it_takes_to_complete_tasks",
              "timeframe",
              "treatment_type",
              "type_work_requests_it",
              "use_agency",
              "user_name",
              "vendor_category",
              "vendor_type",
              "word_count",
              null
            ],
            "example": "priority",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "currency_code": {
            "description": "ISO 4217 currency code to format this custom field. This will be null if the `format` is not `currency`.",
            "example": "EUR",
            "nullable": true,
            "type": "string"
          },
          "custom_label": {
            "description": "This is the string that appears next to the custom field value. This will be null if the `format` is not `custom`.",
            "example": "gold pieces",
            "nullable": true,
            "type": "string"
          },
          "custom_label_position": {
            "description": "Only relevant for custom fields with `custom` format. This depicts where to place the custom label. This will be null if the `format` is not `custom`.",
            "enum": [
              "prefix",
              "suffix",
              null
            ],
            "example": "suffix",
            "nullable": true,
            "type": "string"
          },
          "date_value": {
            "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
            "nullable": true,
            "properties": {
              "date": {
                "description": "A string representing the date in YYYY-MM-DD format.",
                "example": "2024-08-23",
                "type": "string"
              },
              "date_time": {
                "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                "example": "2024-08-23T22:00:00.000Z",
                "type": "string"
              }
            },
            "type": "object"
          },
          "description": {
            "description": "[Opt In](/docs/inputoutput-options). The description of the custom field.",
            "example": "Development team priority",
            "type": "string"
          },
          "display_value": {
            "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
            "example": "blue",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "enabled": {
            "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
            "example": true,
            "readOnly": true,
            "type": "boolean"
          },
          "enum_options": {
            "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
              "properties": {
                "color": {
                  "description": "The color of the enum option. Defaults to `none`.",
                  "example": "blue",
                  "type": "string"
                },
                "enabled": {
                  "description": "Whether or not the enum option is a selectable value for the custom field.",
                  "example": true,
                  "type": "boolean"
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "The name of the enum option.",
                  "example": "Low",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "enum_option"
              }
            },
            "type": "array"
          },
          "enum_value": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
            "nullable": true,
            "properties": {
              "color": {
                "description": "The color of the enum option. Defaults to `none`.",
                "example": "blue",
                "type": "string"
              },
              "enabled": {
                "description": "Whether or not the enum option is a selectable value for the custom field.",
                "example": true,
                "type": "boolean"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the enum option.",
                "example": "Low",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "enum_option"
            }
          },
          "format": {
            "description": "The format of this custom field.",
            "enum": [
              "currency",
              "identifier",
              "percentage",
              "custom",
              "duration",
              "none"
            ],
            "example": "custom",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "has_notifications_enabled": {
            "description": "*Conditional*. This flag describes whether a follower of a task with this field should receive inbox notifications from changes to this field.",
            "example": true,
            "type": "boolean"
          },
          "id_prefix": {
            "description": "This field is the unique custom ID string for the custom field.",
            "example": "ID",
            "nullable": true,
            "type": "string"
          },
          "input_restrictions": {
            "example": [
              "task"
            ],
            "items": {
              "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
              "enum": [
                "task",
                "project",
                "portfolio",
                "goal"
              ],
              "type": "string"
            },
            "type": "array"
          },
          "is_formula_field": {
            "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
            "example": false,
            "type": "boolean"
          },
          "is_global_to_workspace": {
            "description": "This flag describes whether this custom field is available to every container in the workspace. Before project-specific custom fields, this field was always true.",
            "example": true,
            "readOnly": true,
            "type": "boolean"
          },
          "is_lookup_field": {
            "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
            "example": false,
            "type": "boolean"
          },
          "multi_enum_values": {
            "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
              "properties": {
                "color": {
                  "description": "The color of the enum option. Defaults to `none`.",
                  "example": "blue",
                  "type": "string"
                },
                "enabled": {
                  "description": "Whether or not the enum option is a selectable value for the custom field.",
                  "example": true,
                  "type": "boolean"
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "The name of the enum option.",
                  "example": "Low",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "enum_option"
              }
            },
            "type": "array"
          },
          "name": {
            "description": "The name of the custom field.",
            "example": "Status",
            "type": "string"
          },
          "number_value": {
            "description": "*Conditional*. This number is the value of a `number` custom field.",
            "example": 5.2,
            "nullable": true,
            "type": "number"
          },
          "owned_by_app": {
            "description": "*Allow-listed*. Instructs the API that this Custom Field is app-owned. This parameter is allow-listed to specific apps at this point in time. For apps that are not allow-listed, providing this parameter will result in a `403 Forbidden`.",
            "type": "boolean"
          },
          "people_value": {
            "description": "*Conditional*. Only relevant for custom fields of type `people`. This array of user GIDs, emails, or the string \"me\", reflects the users to be written to a `people` custom field. Note that *write* operations will replace existing users (if any) in the custom field with the users specified in this array.",
            "example": [
              "12345"
            ],
            "items": {
              "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
              "type": "string"
            },
            "type": "array"
          },
          "precision": {
            "description": "Only relevant for custom fields of type `Number`. This field dictates the number of places after the decimal to round to, i.e. 0 is integer values, 1 rounds to the nearest tenth, and so on. Must be between 0 and 6, inclusive.\nFor percentage format, this may be unintuitive, as a value of 0.25 has a precision of 0, while a value of 0.251 has a precision of 1. This is due to 0.25 being displayed as 25%.\nThe identifier format will always have a precision of 0.",
            "example": 2,
            "type": "integer"
          },
          "reference_value": {
            "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of GIDs reflects the objects to be written to a `reference` custom field. Note that *write* operations will replace existing objects (if any) in the custom field with the objects specified in this array.",
            "example": [
              "12345"
            ],
            "items": {
              "description": "The GID of an object.",
              "type": "string"
            },
            "type": "array"
          },
          "representation_type": {
            "description": "This field tells the type of the custom field.",
            "enum": [
              "text",
              "enum",
              "multi_enum",
              "number",
              "date",
              "people",
              "formula",
              "custom_id",
              "reference"
            ],
            "example": "number",
            "readOnly": true,
            "type": "string"
          },
          "resource_subtype": {
            "description": "The type of the custom field. Must be one of the given values.",
            "enum": [
              "text",
              "enum",
              "multi_enum",
              "number",
              "date",
              "people",
              "reference"
            ],
            "example": "text",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "text_value": {
            "description": "*Conditional*. This string is the value of a `text` custom field.",
            "example": "Some Value",
            "nullable": true,
            "type": "string"
          },
          "type": {
            "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
            "enum": [
              "text",
              "enum",
              "multi_enum",
              "number",
              "date",
              "people",
              "reference"
            ],
            "readOnly": true,
            "type": "string"
          },
          "workspace": {
            "description": "*Create-Only* The workspace to create a custom field in.",
            "example": "1331",
            "type": "string"
          }
        },
        "required": [
          "workspace",
          "resource_subtype"
        ],
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "custom_field"
        }
      },
      "sdk__CustomFieldMembershipBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object describes a user or team's membership to a custom field including their level of access (Admin, Editor, or User).",
        "properties": {
          "access_level": {
            "description": "Whether the member has admin, editor, or user access to the custom field.",
            "enum": [
              "admin",
              "editor",
              "user"
            ],
            "example": "admin",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the member",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of the member (team or user)",
                "example": "user",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "member"
            }
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.",
            "properties": {
              "date_value": {
                "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                "nullable": true,
                "properties": {
                  "date": {
                    "description": "A string representing the date in YYYY-MM-DD format.",
                    "example": "2024-08-23",
                    "type": "string"
                  },
                  "date_time": {
                    "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                    "example": "2024-08-23T22:00:00.000Z",
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "display_value": {
                "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                "example": "blue",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "enabled": {
                "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                "example": true,
                "readOnly": true,
                "type": "boolean"
              },
              "enum_options": {
                "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                "items": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                  "properties": {
                    "color": {
                      "description": "The color of the enum option. Defaults to `none`.",
                      "example": "blue",
                      "type": "string"
                    },
                    "enabled": {
                      "description": "Whether or not the enum option is a selectable value for the custom field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the enum option.",
                      "example": "Low",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "enum_option"
                  }
                },
                "type": "array"
              },
              "enum_value": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                "nullable": true,
                "properties": {
                  "color": {
                    "description": "The color of the enum option. Defaults to `none`.",
                    "example": "blue",
                    "type": "string"
                  },
                  "enabled": {
                    "description": "Whether or not the enum option is a selectable value for the custom field.",
                    "example": true,
                    "type": "boolean"
                  },
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the enum option.",
                    "example": "Low",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "enum_option"
                }
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "id_prefix": {
                "description": "This field is the unique custom ID string for the custom field.",
                "example": "ID",
                "nullable": true,
                "type": "string"
              },
              "input_restrictions": {
                "example": [
                  "task"
                ],
                "items": {
                  "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                  "enum": [
                    "task",
                    "project",
                    "portfolio",
                    "goal"
                  ],
                  "type": "string"
                },
                "type": "array"
              },
              "is_formula_field": {
                "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                "example": false,
                "type": "boolean"
              },
              "is_lookup_field": {
                "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                "example": false,
                "type": "boolean"
              },
              "multi_enum_values": {
                "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                "items": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                  "properties": {
                    "color": {
                      "description": "The color of the enum option. Defaults to `none`.",
                      "example": "blue",
                      "type": "string"
                    },
                    "enabled": {
                      "description": "Whether or not the enum option is a selectable value for the custom field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the enum option.",
                      "example": "Low",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "enum_option"
                  }
                },
                "type": "array"
              },
              "name": {
                "description": "The name of the custom field.",
                "example": "Status",
                "type": "string"
              },
              "number_value": {
                "description": "*Conditional*. This number is the value of a `number` custom field.",
                "example": 5.2,
                "nullable": true,
                "type": "number"
              },
              "representation_type": {
                "description": "This field tells the type of the custom field.",
                "enum": [
                  "text",
                  "enum",
                  "multi_enum",
                  "number",
                  "date",
                  "people",
                  "formula",
                  "custom_id",
                  "reference"
                ],
                "example": "number",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              },
              "text_value": {
                "description": "*Conditional*. This string is the value of a `text` custom field.",
                "example": "Some Value",
                "nullable": true,
                "type": "string"
              },
              "type": {
                "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                "enum": [
                  "text",
                  "enum",
                  "multi_enum",
                  "number",
                  "date",
                  "people",
                  "reference"
                ],
                "readOnly": true,
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "custom_field"
            }
          },
          "resource_subtype": {
            "description": "Type of the membership.",
            "example": "custom_field_membership",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "custom_field_membership"
        }
      },
      "sdk__CustomFieldMembershipCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object describes a user or team's membership to a custom field including their level of access (Admin, Editor, or User).",
        "properties": {
          "access_level": {
            "description": "Whether the member has admin, editor, or user access to the custom field.",
            "enum": [
              "admin",
              "editor",
              "user"
            ],
            "example": "admin",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the member",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of the member (team or user)",
                "example": "user",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "member"
            }
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.",
            "properties": {
              "date_value": {
                "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                "nullable": true,
                "properties": {
                  "date": {
                    "description": "A string representing the date in YYYY-MM-DD format.",
                    "example": "2024-08-23",
                    "type": "string"
                  },
                  "date_time": {
                    "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                    "example": "2024-08-23T22:00:00.000Z",
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "display_value": {
                "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                "example": "blue",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "enabled": {
                "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                "example": true,
                "readOnly": true,
                "type": "boolean"
              },
              "enum_options": {
                "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                "items": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                  "properties": {
                    "color": {
                      "description": "The color of the enum option. Defaults to `none`.",
                      "example": "blue",
                      "type": "string"
                    },
                    "enabled": {
                      "description": "Whether or not the enum option is a selectable value for the custom field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the enum option.",
                      "example": "Low",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "enum_option"
                  }
                },
                "type": "array"
              },
              "enum_value": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                "nullable": true,
                "properties": {
                  "color": {
                    "description": "The color of the enum option. Defaults to `none`.",
                    "example": "blue",
                    "type": "string"
                  },
                  "enabled": {
                    "description": "Whether or not the enum option is a selectable value for the custom field.",
                    "example": true,
                    "type": "boolean"
                  },
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the enum option.",
                    "example": "Low",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "enum_option"
                }
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "id_prefix": {
                "description": "This field is the unique custom ID string for the custom field.",
                "example": "ID",
                "nullable": true,
                "type": "string"
              },
              "input_restrictions": {
                "example": [
                  "task"
                ],
                "items": {
                  "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                  "enum": [
                    "task",
                    "project",
                    "portfolio",
                    "goal"
                  ],
                  "type": "string"
                },
                "type": "array"
              },
              "is_formula_field": {
                "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                "example": false,
                "type": "boolean"
              },
              "is_lookup_field": {
                "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                "example": false,
                "type": "boolean"
              },
              "multi_enum_values": {
                "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                "items": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                  "properties": {
                    "color": {
                      "description": "The color of the enum option. Defaults to `none`.",
                      "example": "blue",
                      "type": "string"
                    },
                    "enabled": {
                      "description": "Whether or not the enum option is a selectable value for the custom field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the enum option.",
                      "example": "Low",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "enum_option"
                  }
                },
                "type": "array"
              },
              "name": {
                "description": "The name of the custom field.",
                "example": "Status",
                "type": "string"
              },
              "number_value": {
                "description": "*Conditional*. This number is the value of a `number` custom field.",
                "example": 5.2,
                "nullable": true,
                "type": "number"
              },
              "representation_type": {
                "description": "This field tells the type of the custom field.",
                "enum": [
                  "text",
                  "enum",
                  "multi_enum",
                  "number",
                  "date",
                  "people",
                  "formula",
                  "custom_id",
                  "reference"
                ],
                "example": "number",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              },
              "text_value": {
                "description": "*Conditional*. This string is the value of a `text` custom field.",
                "example": "Some Value",
                "nullable": true,
                "type": "string"
              },
              "type": {
                "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                "enum": [
                  "text",
                  "enum",
                  "multi_enum",
                  "number",
                  "date",
                  "people",
                  "reference"
                ],
                "readOnly": true,
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "custom_field"
            }
          },
          "resource_subtype": {
            "description": "Type of the membership.",
            "example": "custom_field_membership",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "custom_field_membership"
        }
      },
      "sdk__CustomFieldMembershipResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object describes a user or team's membership to a custom field including their level of access (Admin, Editor, or User).",
        "properties": {
          "access_level": {
            "description": "Whether the member has admin, editor, or user access to the custom field.",
            "enum": [
              "admin",
              "editor",
              "user"
            ],
            "example": "admin",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the member",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of the member (team or user)",
                "example": "user",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "member"
            }
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.",
            "properties": {
              "date_value": {
                "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                "nullable": true,
                "properties": {
                  "date": {
                    "description": "A string representing the date in YYYY-MM-DD format.",
                    "example": "2024-08-23",
                    "type": "string"
                  },
                  "date_time": {
                    "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                    "example": "2024-08-23T22:00:00.000Z",
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "display_value": {
                "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                "example": "blue",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "enabled": {
                "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                "example": true,
                "readOnly": true,
                "type": "boolean"
              },
              "enum_options": {
                "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                "items": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                  "properties": {
                    "color": {
                      "description": "The color of the enum option. Defaults to `none`.",
                      "example": "blue",
                      "type": "string"
                    },
                    "enabled": {
                      "description": "Whether or not the enum option is a selectable value for the custom field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the enum option.",
                      "example": "Low",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "enum_option"
                  }
                },
                "type": "array"
              },
              "enum_value": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                "nullable": true,
                "properties": {
                  "color": {
                    "description": "The color of the enum option. Defaults to `none`.",
                    "example": "blue",
                    "type": "string"
                  },
                  "enabled": {
                    "description": "Whether or not the enum option is a selectable value for the custom field.",
                    "example": true,
                    "type": "boolean"
                  },
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the enum option.",
                    "example": "Low",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "enum_option"
                }
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "id_prefix": {
                "description": "This field is the unique custom ID string for the custom field.",
                "example": "ID",
                "nullable": true,
                "type": "string"
              },
              "input_restrictions": {
                "example": [
                  "task"
                ],
                "items": {
                  "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                  "enum": [
                    "task",
                    "project",
                    "portfolio",
                    "goal"
                  ],
                  "type": "string"
                },
                "type": "array"
              },
              "is_formula_field": {
                "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                "example": false,
                "type": "boolean"
              },
              "is_lookup_field": {
                "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                "example": false,
                "type": "boolean"
              },
              "multi_enum_values": {
                "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                "items": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                  "properties": {
                    "color": {
                      "description": "The color of the enum option. Defaults to `none`.",
                      "example": "blue",
                      "type": "string"
                    },
                    "enabled": {
                      "description": "Whether or not the enum option is a selectable value for the custom field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the enum option.",
                      "example": "Low",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "enum_option"
                  }
                },
                "type": "array"
              },
              "name": {
                "description": "The name of the custom field.",
                "example": "Status",
                "type": "string"
              },
              "number_value": {
                "description": "*Conditional*. This number is the value of a `number` custom field.",
                "example": 5.2,
                "nullable": true,
                "type": "number"
              },
              "representation_type": {
                "description": "This field tells the type of the custom field.",
                "enum": [
                  "text",
                  "enum",
                  "multi_enum",
                  "number",
                  "date",
                  "people",
                  "formula",
                  "custom_id",
                  "reference"
                ],
                "example": "number",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              },
              "text_value": {
                "description": "*Conditional*. This string is the value of a `text` custom field.",
                "example": "Some Value",
                "nullable": true,
                "type": "string"
              },
              "type": {
                "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                "enum": [
                  "text",
                  "enum",
                  "multi_enum",
                  "number",
                  "date",
                  "people",
                  "reference"
                ],
                "readOnly": true,
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "custom_field"
            }
          },
          "resource_subtype": {
            "description": "Type of the membership.",
            "example": "custom_field_membership",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "custom_field_membership"
        }
      },
      "sdk__CustomFieldRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.",
        "properties": {
          "asana_created_field": {
            "description": "*Conditional*. A unique identifier to associate this field with the template source of truth.",
            "enum": [
              "a_v_requirements",
              "account_name",
              "actionable",
              "align_shipping_link",
              "align_status",
              "allotted_time",
              "appointment",
              "approval_stage",
              "approved",
              "article_series",
              "board_committee",
              "browser",
              "campaign_audience",
              "campaign_project_status",
              "campaign_regions",
              "channel_primary",
              "client_topic_type",
              "complete_by",
              "contact",
              "contact_email_address",
              "content_channels",
              "content_channels_needed",
              "content_stage",
              "content_type",
              "contract",
              "contract_status",
              "cost",
              "creation_stage",
              "creative_channel",
              "creative_needed",
              "creative_needs",
              "data_sensitivity",
              "deal_size",
              "delivery_appt",
              "delivery_appt_date",
              "department",
              "department_responsible",
              "design_request_needed",
              "design_request_type",
              "discussion_category",
              "do_this_task",
              "editorial_content_status",
              "editorial_content_tag",
              "editorial_content_type",
              "effort",
              "effort_level",
              "est_completion_date",
              "estimated_time",
              "estimated_value",
              "expected_cost",
              "external_steps_needed",
              "favorite_idea",
              "feedback_type",
              "financial",
              "funding_amount",
              "grant_application_process",
              "hiring_candidate_status",
              "idea_status",
              "ids_link",
              "ids_patient_link",
              "implementation_stage",
              "insurance",
              "interview_area",
              "interview_question_score",
              "itero_scan_link",
              "job_s_applied_to",
              "lab",
              "launch_status",
              "lead_status",
              "localization_language",
              "localization_market_team",
              "localization_status",
              "meeting_minutes",
              "meeting_needed",
              "minutes",
              "mrr",
              "must_localize",
              "name_of_foundation",
              "need_to_follow_up",
              "next_appointment",
              "next_steps_sales",
              "num_people",
              "number_of_user_reports",
              "office_location",
              "onboarding_activity",
              "owner",
              "participants_needed",
              "patient_date_of_birth",
              "patient_email",
              "patient_phone",
              "patient_status",
              "phone_number",
              "planning_category",
              "point_of_contact",
              "position",
              "post_format",
              "prescription",
              "priority",
              "priority_level",
              "product",
              "product_stage",
              "progress",
              "project_size",
              "project_status",
              "proposed_budget",
              "publish_status",
              "reason_for_scan",
              "referral",
              "request_type",
              "research_status",
              "responsible_department",
              "responsible_team",
              "risk_assessment_status",
              "room_name",
              "sales_counterpart",
              "sentiment",
              "shipping_link",
              "social_channels",
              "stage",
              "status",
              "status_design",
              "status_of_initiative",
              "system_setup",
              "task_progress",
              "team",
              "team_marketing",
              "team_responsible",
              "time_it_takes_to_complete_tasks",
              "timeframe",
              "treatment_type",
              "type_work_requests_it",
              "use_agency",
              "user_name",
              "vendor_category",
              "vendor_type",
              "word_count",
              null
            ],
            "example": "priority",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "currency_code": {
            "description": "ISO 4217 currency code to format this custom field. This will be null if the `format` is not `currency`.",
            "example": "EUR",
            "nullable": true,
            "type": "string"
          },
          "custom_label": {
            "description": "This is the string that appears next to the custom field value. This will be null if the `format` is not `custom`.",
            "example": "gold pieces",
            "nullable": true,
            "type": "string"
          },
          "custom_label_position": {
            "description": "Only relevant for custom fields with `custom` format. This depicts where to place the custom label. This will be null if the `format` is not `custom`.",
            "enum": [
              "prefix",
              "suffix",
              null
            ],
            "example": "suffix",
            "nullable": true,
            "type": "string"
          },
          "date_value": {
            "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
            "nullable": true,
            "properties": {
              "date": {
                "description": "A string representing the date in YYYY-MM-DD format.",
                "example": "2024-08-23",
                "type": "string"
              },
              "date_time": {
                "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                "example": "2024-08-23T22:00:00.000Z",
                "type": "string"
              }
            },
            "type": "object"
          },
          "description": {
            "description": "[Opt In](/docs/inputoutput-options). The description of the custom field.",
            "example": "Development team priority",
            "type": "string"
          },
          "display_value": {
            "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
            "example": "blue",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "enabled": {
            "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
            "example": true,
            "readOnly": true,
            "type": "boolean"
          },
          "enum_options": {
            "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
              "properties": {
                "color": {
                  "description": "The color of the enum option. Defaults to `none`.",
                  "example": "blue",
                  "type": "string"
                },
                "enabled": {
                  "description": "Whether or not the enum option is a selectable value for the custom field.",
                  "example": true,
                  "type": "boolean"
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "The name of the enum option.",
                  "example": "Low",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "enum_option"
              }
            },
            "type": "array"
          },
          "enum_value": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
            "nullable": true,
            "properties": {
              "color": {
                "description": "The color of the enum option. Defaults to `none`.",
                "example": "blue",
                "type": "string"
              },
              "enabled": {
                "description": "Whether or not the enum option is a selectable value for the custom field.",
                "example": true,
                "type": "boolean"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the enum option.",
                "example": "Low",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "enum_option"
            }
          },
          "format": {
            "description": "The format of this custom field.",
            "enum": [
              "currency",
              "identifier",
              "percentage",
              "custom",
              "duration",
              "none"
            ],
            "example": "custom",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "has_notifications_enabled": {
            "description": "*Conditional*. This flag describes whether a follower of a task with this field should receive inbox notifications from changes to this field.",
            "example": true,
            "type": "boolean"
          },
          "id_prefix": {
            "description": "This field is the unique custom ID string for the custom field.",
            "example": "ID",
            "nullable": true,
            "type": "string"
          },
          "input_restrictions": {
            "example": [
              "task"
            ],
            "items": {
              "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
              "enum": [
                "task",
                "project",
                "portfolio",
                "goal"
              ],
              "type": "string"
            },
            "type": "array"
          },
          "is_formula_field": {
            "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
            "example": false,
            "type": "boolean"
          },
          "is_global_to_workspace": {
            "description": "This flag describes whether this custom field is available to every container in the workspace. Before project-specific custom fields, this field was always true.",
            "example": true,
            "readOnly": true,
            "type": "boolean"
          },
          "is_lookup_field": {
            "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
            "example": false,
            "type": "boolean"
          },
          "multi_enum_values": {
            "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
              "properties": {
                "color": {
                  "description": "The color of the enum option. Defaults to `none`.",
                  "example": "blue",
                  "type": "string"
                },
                "enabled": {
                  "description": "Whether or not the enum option is a selectable value for the custom field.",
                  "example": true,
                  "type": "boolean"
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "The name of the enum option.",
                  "example": "Low",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "enum_option"
              }
            },
            "type": "array"
          },
          "name": {
            "description": "The name of the custom field.",
            "example": "Status",
            "type": "string"
          },
          "number_value": {
            "description": "*Conditional*. This number is the value of a `number` custom field.",
            "example": 5.2,
            "nullable": true,
            "type": "number"
          },
          "owned_by_app": {
            "description": "*Allow-listed*. Instructs the API that this Custom Field is app-owned. This parameter is allow-listed to specific apps at this point in time. For apps that are not allow-listed, providing this parameter will result in a `403 Forbidden`.",
            "type": "boolean"
          },
          "people_value": {
            "description": "*Conditional*. Only relevant for custom fields of type `people`. This array of user GIDs, emails, or the string \"me\", reflects the users to be written to a `people` custom field. Note that *write* operations will replace existing users (if any) in the custom field with the users specified in this array.",
            "example": [
              "12345"
            ],
            "items": {
              "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
              "type": "string"
            },
            "type": "array"
          },
          "precision": {
            "description": "Only relevant for custom fields of type `Number`. This field dictates the number of places after the decimal to round to, i.e. 0 is integer values, 1 rounds to the nearest tenth, and so on. Must be between 0 and 6, inclusive.\nFor percentage format, this may be unintuitive, as a value of 0.25 has a precision of 0, while a value of 0.251 has a precision of 1. This is due to 0.25 being displayed as 25%.\nThe identifier format will always have a precision of 0.",
            "example": 2,
            "type": "integer"
          },
          "reference_value": {
            "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of GIDs reflects the objects to be written to a `reference` custom field. Note that *write* operations will replace existing objects (if any) in the custom field with the objects specified in this array.",
            "example": [
              "12345"
            ],
            "items": {
              "description": "The GID of an object.",
              "type": "string"
            },
            "type": "array"
          },
          "representation_type": {
            "description": "This field tells the type of the custom field.",
            "enum": [
              "text",
              "enum",
              "multi_enum",
              "number",
              "date",
              "people",
              "formula",
              "custom_id",
              "reference"
            ],
            "example": "number",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "text_value": {
            "description": "*Conditional*. This string is the value of a `text` custom field.",
            "example": "Some Value",
            "nullable": true,
            "type": "string"
          },
          "type": {
            "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
            "enum": [
              "text",
              "enum",
              "multi_enum",
              "number",
              "date",
              "people",
              "reference"
            ],
            "readOnly": true,
            "type": "string"
          },
          "workspace": {
            "description": "*Create-Only* The workspace to create a custom field in.",
            "example": "1331",
            "type": "string"
          }
        },
        "required": [
          "workspace"
        ],
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "custom_field"
        }
      },
      "sdk__CustomFieldResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.",
        "properties": {
          "asana_created_field": {
            "description": "*Conditional*. A unique identifier to associate this field with the template source of truth.",
            "enum": [
              "a_v_requirements",
              "account_name",
              "actionable",
              "align_shipping_link",
              "align_status",
              "allotted_time",
              "appointment",
              "approval_stage",
              "approved",
              "article_series",
              "board_committee",
              "browser",
              "campaign_audience",
              "campaign_project_status",
              "campaign_regions",
              "channel_primary",
              "client_topic_type",
              "complete_by",
              "contact",
              "contact_email_address",
              "content_channels",
              "content_channels_needed",
              "content_stage",
              "content_type",
              "contract",
              "contract_status",
              "cost",
              "creation_stage",
              "creative_channel",
              "creative_needed",
              "creative_needs",
              "data_sensitivity",
              "deal_size",
              "delivery_appt",
              "delivery_appt_date",
              "department",
              "department_responsible",
              "design_request_needed",
              "design_request_type",
              "discussion_category",
              "do_this_task",
              "editorial_content_status",
              "editorial_content_tag",
              "editorial_content_type",
              "effort",
              "effort_level",
              "est_completion_date",
              "estimated_time",
              "estimated_value",
              "expected_cost",
              "external_steps_needed",
              "favorite_idea",
              "feedback_type",
              "financial",
              "funding_amount",
              "grant_application_process",
              "hiring_candidate_status",
              "idea_status",
              "ids_link",
              "ids_patient_link",
              "implementation_stage",
              "insurance",
              "interview_area",
              "interview_question_score",
              "itero_scan_link",
              "job_s_applied_to",
              "lab",
              "launch_status",
              "lead_status",
              "localization_language",
              "localization_market_team",
              "localization_status",
              "meeting_minutes",
              "meeting_needed",
              "minutes",
              "mrr",
              "must_localize",
              "name_of_foundation",
              "need_to_follow_up",
              "next_appointment",
              "next_steps_sales",
              "num_people",
              "number_of_user_reports",
              "office_location",
              "onboarding_activity",
              "owner",
              "participants_needed",
              "patient_date_of_birth",
              "patient_email",
              "patient_phone",
              "patient_status",
              "phone_number",
              "planning_category",
              "point_of_contact",
              "position",
              "post_format",
              "prescription",
              "priority",
              "priority_level",
              "product",
              "product_stage",
              "progress",
              "project_size",
              "project_status",
              "proposed_budget",
              "publish_status",
              "reason_for_scan",
              "referral",
              "request_type",
              "research_status",
              "responsible_department",
              "responsible_team",
              "risk_assessment_status",
              "room_name",
              "sales_counterpart",
              "sentiment",
              "shipping_link",
              "social_channels",
              "stage",
              "status",
              "status_design",
              "status_of_initiative",
              "system_setup",
              "task_progress",
              "team",
              "team_marketing",
              "team_responsible",
              "time_it_takes_to_complete_tasks",
              "timeframe",
              "treatment_type",
              "type_work_requests_it",
              "use_agency",
              "user_name",
              "vendor_category",
              "vendor_type",
              "word_count",
              null
            ],
            "example": "priority",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "created_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "currency_code": {
            "description": "ISO 4217 currency code to format this custom field. This will be null if the `format` is not `currency`.",
            "example": "EUR",
            "nullable": true,
            "type": "string"
          },
          "custom_label": {
            "description": "This is the string that appears next to the custom field value. This will be null if the `format` is not `custom`.",
            "example": "gold pieces",
            "nullable": true,
            "type": "string"
          },
          "custom_label_position": {
            "description": "Only relevant for custom fields with `custom` format. This depicts where to place the custom label. This will be null if the `format` is not `custom`.",
            "enum": [
              "prefix",
              "suffix",
              null
            ],
            "example": "suffix",
            "nullable": true,
            "type": "string"
          },
          "date_value": {
            "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
            "nullable": true,
            "properties": {
              "date": {
                "description": "A string representing the date in YYYY-MM-DD format.",
                "example": "2024-08-23",
                "type": "string"
              },
              "date_time": {
                "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                "example": "2024-08-23T22:00:00.000Z",
                "type": "string"
              }
            },
            "type": "object"
          },
          "default_access_level": {
            "description": "The default access level when inviting new members to the custom field. This isn't applied when the `privacy_setting` is `private`, or the user is a guest. For local fields in a project or portfolio, the user must additionally have permission to modify the container itself.",
            "enum": [
              "admin",
              "editor",
              "user"
            ],
            "example": "user",
            "type": "string"
          },
          "description": {
            "description": "[Opt In](/docs/inputoutput-options). The description of the custom field.",
            "example": "Development team priority",
            "type": "string"
          },
          "display_value": {
            "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
            "example": "blue",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "enabled": {
            "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
            "example": true,
            "readOnly": true,
            "type": "boolean"
          },
          "enum_options": {
            "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
              "properties": {
                "color": {
                  "description": "The color of the enum option. Defaults to `none`.",
                  "example": "blue",
                  "type": "string"
                },
                "enabled": {
                  "description": "Whether or not the enum option is a selectable value for the custom field.",
                  "example": true,
                  "type": "boolean"
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "The name of the enum option.",
                  "example": "Low",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "enum_option"
              }
            },
            "type": "array"
          },
          "enum_value": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
            "nullable": true,
            "properties": {
              "color": {
                "description": "The color of the enum option. Defaults to `none`.",
                "example": "blue",
                "type": "string"
              },
              "enabled": {
                "description": "Whether or not the enum option is a selectable value for the custom field.",
                "example": true,
                "type": "boolean"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the enum option.",
                "example": "Low",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "enum_option"
            }
          },
          "format": {
            "description": "The format of this custom field.",
            "enum": [
              "currency",
              "identifier",
              "percentage",
              "custom",
              "duration",
              "none"
            ],
            "example": "custom",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "has_notifications_enabled": {
            "description": "*Conditional*. This flag describes whether a follower of a task with this field should receive inbox notifications from changes to this field.",
            "example": true,
            "type": "boolean"
          },
          "html_text_value": {
            "description": "*Conditional*. Only relevant for custom fields of type `text`. This is the HTML representation of the text value of a custom field, corresponding to the `text_value` plain-text field. See [rich text](/docs/rich-text#reading-rich-text).",
            "example": "<body>Some Value</body>",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "id_prefix": {
            "description": "This field is the unique custom ID string for the custom field.",
            "example": "ID",
            "nullable": true,
            "type": "string"
          },
          "input_restrictions": {
            "example": [
              "task"
            ],
            "items": {
              "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
              "enum": [
                "task",
                "project",
                "portfolio",
                "goal"
              ],
              "type": "string"
            },
            "type": "array"
          },
          "is_formula_field": {
            "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
            "example": false,
            "type": "boolean"
          },
          "is_global_to_workspace": {
            "description": "This flag describes whether this custom field is available to every container in the workspace. Before project-specific custom fields, this field was always true.",
            "example": true,
            "readOnly": true,
            "type": "boolean"
          },
          "is_lookup_field": {
            "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
            "example": false,
            "type": "boolean"
          },
          "is_value_read_only": {
            "description": "*Conditional*. This flag describes whether a custom field is read only.",
            "example": false,
            "type": "boolean"
          },
          "multi_enum_values": {
            "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
              "properties": {
                "color": {
                  "description": "The color of the enum option. Defaults to `none`.",
                  "example": "blue",
                  "type": "string"
                },
                "enabled": {
                  "description": "Whether or not the enum option is a selectable value for the custom field.",
                  "example": true,
                  "type": "boolean"
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "The name of the enum option.",
                  "example": "Low",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "enum_option"
              }
            },
            "type": "array"
          },
          "name": {
            "description": "The name of the custom field.",
            "example": "Status",
            "type": "string"
          },
          "number_value": {
            "description": "*Conditional*. This number is the value of a `number` custom field.",
            "example": 5.2,
            "nullable": true,
            "type": "number"
          },
          "people_value": {
            "description": "*Conditional*. Only relevant for custom fields of type `people`. This array of [compact user](/reference/users) objects reflects the values of a `people` custom field.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "*Read-only except when same user as requester*. The user's name.",
                  "example": "Greg Sanchez",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "user"
              }
            },
            "type": "array"
          },
          "precision": {
            "description": "Only relevant for custom fields of type `Number`. This field dictates the number of places after the decimal to round to, i.e. 0 is integer values, 1 rounds to the nearest tenth, and so on. Must be between 0 and 6, inclusive.\nFor percentage format, this may be unintuitive, as a value of 0.25 has a precision of 0, while a value of 0.251 has a precision of 1. This is due to 0.25 being displayed as 25%.\nThe identifier format will always have a precision of 0.",
            "example": 2,
            "type": "integer"
          },
          "privacy_setting": {
            "description": "The privacy setting of the custom field. *Note: Administrators in your organization may restrict the values of `privacy_setting`.*",
            "enum": [
              "public_with_guests",
              "public",
              "private"
            ],
            "example": "public_with_guests",
            "type": "string"
          },
          "reference_value": {
            "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of objects reflects the values of a `reference` custom field.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "The name of the object.",
                  "example": "Bug Task",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "representation_type": {
            "description": "This field tells the type of the custom field.",
            "enum": [
              "text",
              "enum",
              "multi_enum",
              "number",
              "date",
              "people",
              "formula",
              "custom_id",
              "reference"
            ],
            "example": "number",
            "readOnly": true,
            "type": "string"
          },
          "resource_subtype": {
            "description": "The type of the custom field. Must be one of the given values.\n",
            "enum": [
              "text",
              "enum",
              "multi_enum",
              "number",
              "date",
              "people",
              "reference"
            ],
            "example": "text",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "text_value": {
            "description": "*Conditional*. This string is the value of a `text` custom field.",
            "example": "Some Value",
            "nullable": true,
            "type": "string"
          },
          "type": {
            "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
            "enum": [
              "text",
              "enum",
              "multi_enum",
              "number",
              "date",
              "people",
              "reference"
            ],
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "custom_field"
        }
      },
      "sdk__CustomFieldResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__CustomFieldResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__CustomFieldResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__CustomFieldResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__CustomFieldSettingBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields Settings objects represent the many-to-many join of the Custom Field and Project as well as stores information that is relevant to that particular pairing.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "custom_field_setting"
        }
      },
      "sdk__CustomFieldSettingCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields Settings objects represent the many-to-many join of the Custom Field and Project as well as stores information that is relevant to that particular pairing.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "custom_field_setting"
        }
      },
      "sdk__CustomFieldSettingResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields Settings objects represent the many-to-many join of the Custom Field and Project as well as stores information that is relevant to that particular pairing.",
        "properties": {
          "custom_field": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.\nThe custom field that is applied to the `parent`.",
            "properties": {
              "asana_created_field": {
                "description": "*Conditional*. A unique identifier to associate this field with the template source of truth.",
                "enum": [
                  "a_v_requirements",
                  "account_name",
                  "actionable",
                  "align_shipping_link",
                  "align_status",
                  "allotted_time",
                  "appointment",
                  "approval_stage",
                  "approved",
                  "article_series",
                  "board_committee",
                  "browser",
                  "campaign_audience",
                  "campaign_project_status",
                  "campaign_regions",
                  "channel_primary",
                  "client_topic_type",
                  "complete_by",
                  "contact",
                  "contact_email_address",
                  "content_channels",
                  "content_channels_needed",
                  "content_stage",
                  "content_type",
                  "contract",
                  "contract_status",
                  "cost",
                  "creation_stage",
                  "creative_channel",
                  "creative_needed",
                  "creative_needs",
                  "data_sensitivity",
                  "deal_size",
                  "delivery_appt",
                  "delivery_appt_date",
                  "department",
                  "department_responsible",
                  "design_request_needed",
                  "design_request_type",
                  "discussion_category",
                  "do_this_task",
                  "editorial_content_status",
                  "editorial_content_tag",
                  "editorial_content_type",
                  "effort",
                  "effort_level",
                  "est_completion_date",
                  "estimated_time",
                  "estimated_value",
                  "expected_cost",
                  "external_steps_needed",
                  "favorite_idea",
                  "feedback_type",
                  "financial",
                  "funding_amount",
                  "grant_application_process",
                  "hiring_candidate_status",
                  "idea_status",
                  "ids_link",
                  "ids_patient_link",
                  "implementation_stage",
                  "insurance",
                  "interview_area",
                  "interview_question_score",
                  "itero_scan_link",
                  "job_s_applied_to",
                  "lab",
                  "launch_status",
                  "lead_status",
                  "localization_language",
                  "localization_market_team",
                  "localization_status",
                  "meeting_minutes",
                  "meeting_needed",
                  "minutes",
                  "mrr",
                  "must_localize",
                  "name_of_foundation",
                  "need_to_follow_up",
                  "next_appointment",
                  "next_steps_sales",
                  "num_people",
                  "number_of_user_reports",
                  "office_location",
                  "onboarding_activity",
                  "owner",
                  "participants_needed",
                  "patient_date_of_birth",
                  "patient_email",
                  "patient_phone",
                  "patient_status",
                  "phone_number",
                  "planning_category",
                  "point_of_contact",
                  "position",
                  "post_format",
                  "prescription",
                  "priority",
                  "priority_level",
                  "product",
                  "product_stage",
                  "progress",
                  "project_size",
                  "project_status",
                  "proposed_budget",
                  "publish_status",
                  "reason_for_scan",
                  "referral",
                  "request_type",
                  "research_status",
                  "responsible_department",
                  "responsible_team",
                  "risk_assessment_status",
                  "room_name",
                  "sales_counterpart",
                  "sentiment",
                  "shipping_link",
                  "social_channels",
                  "stage",
                  "status",
                  "status_design",
                  "status_of_initiative",
                  "system_setup",
                  "task_progress",
                  "team",
                  "team_marketing",
                  "team_responsible",
                  "time_it_takes_to_complete_tasks",
                  "timeframe",
                  "treatment_type",
                  "type_work_requests_it",
                  "use_agency",
                  "user_name",
                  "vendor_category",
                  "vendor_type",
                  "word_count",
                  null
                ],
                "example": "priority",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "created_by": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "nullable": true,
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "currency_code": {
                "description": "ISO 4217 currency code to format this custom field. This will be null if the `format` is not `currency`.",
                "example": "EUR",
                "nullable": true,
                "type": "string"
              },
              "custom_label": {
                "description": "This is the string that appears next to the custom field value. This will be null if the `format` is not `custom`.",
                "example": "gold pieces",
                "nullable": true,
                "type": "string"
              },
              "custom_label_position": {
                "description": "Only relevant for custom fields with `custom` format. This depicts where to place the custom label. This will be null if the `format` is not `custom`.",
                "enum": [
                  "prefix",
                  "suffix",
                  null
                ],
                "example": "suffix",
                "nullable": true,
                "type": "string"
              },
              "date_value": {
                "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                "nullable": true,
                "properties": {
                  "date": {
                    "description": "A string representing the date in YYYY-MM-DD format.",
                    "example": "2024-08-23",
                    "type": "string"
                  },
                  "date_time": {
                    "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                    "example": "2024-08-23T22:00:00.000Z",
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "default_access_level": {
                "description": "The default access level when inviting new members to the custom field. This isn't applied when the `privacy_setting` is `private`, or the user is a guest. For local fields in a project or portfolio, the user must additionally have permission to modify the container itself.",
                "enum": [
                  "admin",
                  "editor",
                  "user"
                ],
                "example": "user",
                "type": "string"
              },
              "description": {
                "description": "[Opt In](/docs/inputoutput-options). The description of the custom field.",
                "example": "Development team priority",
                "type": "string"
              },
              "display_value": {
                "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                "example": "blue",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "enabled": {
                "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                "example": true,
                "readOnly": true,
                "type": "boolean"
              },
              "enum_options": {
                "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                "items": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                  "properties": {
                    "color": {
                      "description": "The color of the enum option. Defaults to `none`.",
                      "example": "blue",
                      "type": "string"
                    },
                    "enabled": {
                      "description": "Whether or not the enum option is a selectable value for the custom field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the enum option.",
                      "example": "Low",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "enum_option"
                  }
                },
                "type": "array"
              },
              "enum_value": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                "nullable": true,
                "properties": {
                  "color": {
                    "description": "The color of the enum option. Defaults to `none`.",
                    "example": "blue",
                    "type": "string"
                  },
                  "enabled": {
                    "description": "Whether or not the enum option is a selectable value for the custom field.",
                    "example": true,
                    "type": "boolean"
                  },
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the enum option.",
                    "example": "Low",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "enum_option"
                }
              },
              "format": {
                "description": "The format of this custom field.",
                "enum": [
                  "currency",
                  "identifier",
                  "percentage",
                  "custom",
                  "duration",
                  "none"
                ],
                "example": "custom",
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "has_notifications_enabled": {
                "description": "*Conditional*. This flag describes whether a follower of a task with this field should receive inbox notifications from changes to this field.",
                "example": true,
                "type": "boolean"
              },
              "html_text_value": {
                "description": "*Conditional*. Only relevant for custom fields of type `text`. This is the HTML representation of the text value of a custom field, corresponding to the `text_value` plain-text field. See [rich text](/docs/rich-text#reading-rich-text).",
                "example": "<body>Some Value</body>",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "id_prefix": {
                "description": "This field is the unique custom ID string for the custom field.",
                "example": "ID",
                "nullable": true,
                "type": "string"
              },
              "input_restrictions": {
                "example": [
                  "task"
                ],
                "items": {
                  "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                  "enum": [
                    "task",
                    "project",
                    "portfolio",
                    "goal"
                  ],
                  "type": "string"
                },
                "type": "array"
              },
              "is_formula_field": {
                "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                "example": false,
                "type": "boolean"
              },
              "is_global_to_workspace": {
                "description": "This flag describes whether this custom field is available to every container in the workspace. Before project-specific custom fields, this field was always true.",
                "example": true,
                "readOnly": true,
                "type": "boolean"
              },
              "is_lookup_field": {
                "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                "example": false,
                "type": "boolean"
              },
              "is_value_read_only": {
                "description": "*Conditional*. This flag describes whether a custom field is read only.",
                "example": false,
                "type": "boolean"
              },
              "multi_enum_values": {
                "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                "items": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                  "properties": {
                    "color": {
                      "description": "The color of the enum option. Defaults to `none`.",
                      "example": "blue",
                      "type": "string"
                    },
                    "enabled": {
                      "description": "Whether or not the enum option is a selectable value for the custom field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the enum option.",
                      "example": "Low",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "enum_option"
                  }
                },
                "type": "array"
              },
              "name": {
                "description": "The name of the custom field.",
                "example": "Status",
                "type": "string"
              },
              "number_value": {
                "description": "*Conditional*. This number is the value of a `number` custom field.",
                "example": 5.2,
                "nullable": true,
                "type": "number"
              },
              "people_value": {
                "description": "*Conditional*. Only relevant for custom fields of type `people`. This array of [compact user](/reference/users) objects reflects the values of a `people` custom field.",
                "items": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "*Read-only except when same user as requester*. The user's name.",
                      "example": "Greg Sanchez",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "user"
                  }
                },
                "type": "array"
              },
              "precision": {
                "description": "Only relevant for custom fields of type `Number`. This field dictates the number of places after the decimal to round to, i.e. 0 is integer values, 1 rounds to the nearest tenth, and so on. Must be between 0 and 6, inclusive.\nFor percentage format, this may be unintuitive, as a value of 0.25 has a precision of 0, while a value of 0.251 has a precision of 1. This is due to 0.25 being displayed as 25%.\nThe identifier format will always have a precision of 0.",
                "example": 2,
                "type": "integer"
              },
              "privacy_setting": {
                "description": "The privacy setting of the custom field. *Note: Administrators in your organization may restrict the values of `privacy_setting`.*",
                "enum": [
                  "public_with_guests",
                  "public",
                  "private"
                ],
                "example": "public_with_guests",
                "type": "string"
              },
              "reference_value": {
                "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of objects reflects the values of a `reference` custom field.",
                "items": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the object.",
                      "example": "Bug Task",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object"
                },
                "type": "array"
              },
              "representation_type": {
                "description": "This field tells the type of the custom field.",
                "enum": [
                  "text",
                  "enum",
                  "multi_enum",
                  "number",
                  "date",
                  "people",
                  "formula",
                  "custom_id",
                  "reference"
                ],
                "example": "number",
                "readOnly": true,
                "type": "string"
              },
              "resource_subtype": {
                "description": "The type of the custom field. Must be one of the given values.\n",
                "enum": [
                  "text",
                  "enum",
                  "multi_enum",
                  "number",
                  "date",
                  "people",
                  "reference"
                ],
                "example": "text",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              },
              "text_value": {
                "description": "*Conditional*. This string is the value of a `text` custom field.",
                "example": "Some Value",
                "nullable": true,
                "type": "string"
              },
              "type": {
                "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                "enum": [
                  "text",
                  "enum",
                  "multi_enum",
                  "number",
                  "date",
                  "people",
                  "reference"
                ],
                "readOnly": true,
                "type": "string"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "custom_field"
            }
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "is_important": {
            "description": "`is_important` is used in the Asana web application to determine if this custom field is displayed in the list/grid view of a project or portfolio.",
            "example": false,
            "readOnly": true,
            "type": "boolean"
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\nThe parent to which the custom field is applied. This can be a project or portfolio and indicates that the tasks or projects that the parent contains may be given custom field values for this custom field.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          "project": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\n*Deprecated: new integrations should prefer the `parent` field.* The id of the project that this custom field settings refers to.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "custom_field_setting"
        }
      },
      "sdk__CustomFieldSettingResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__CustomFieldSettingResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__CustomFieldSettingResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__CustomFieldSettingResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__CustomFieldTableSettingBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *custom field table setting* represents the many-to-many join of a custom field and a table, storing information relevant to that particular pairing.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "custom_field_setting"
        }
      },
      "sdk__CustomFieldTableSettingCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *custom field table setting* represents the many-to-many join of a custom field and a table, storing information relevant to that particular pairing.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "custom_field_setting"
        }
      },
      "sdk__CustomFieldTableSettingResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *custom field table setting* represents the many-to-many join of a custom field and a table, storing information relevant to that particular pairing.",
        "properties": {
          "custom_field": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.\nThe custom field that is applied to the table.",
            "properties": {
              "date_value": {
                "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                "nullable": true,
                "properties": {
                  "date": {
                    "description": "A string representing the date in YYYY-MM-DD format.",
                    "example": "2024-08-23",
                    "type": "string"
                  },
                  "date_time": {
                    "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                    "example": "2024-08-23T22:00:00.000Z",
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "display_value": {
                "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                "example": "blue",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "enabled": {
                "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                "example": true,
                "readOnly": true,
                "type": "boolean"
              },
              "enum_options": {
                "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                "items": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                  "properties": {
                    "color": {
                      "description": "The color of the enum option. Defaults to `none`.",
                      "example": "blue",
                      "type": "string"
                    },
                    "enabled": {
                      "description": "Whether or not the enum option is a selectable value for the custom field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the enum option.",
                      "example": "Low",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "enum_option"
                  }
                },
                "type": "array"
              },
              "enum_value": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                "nullable": true,
                "properties": {
                  "color": {
                    "description": "The color of the enum option. Defaults to `none`.",
                    "example": "blue",
                    "type": "string"
                  },
                  "enabled": {
                    "description": "Whether or not the enum option is a selectable value for the custom field.",
                    "example": true,
                    "type": "boolean"
                  },
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the enum option.",
                    "example": "Low",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "enum_option"
                }
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "id_prefix": {
                "description": "This field is the unique custom ID string for the custom field.",
                "example": "ID",
                "nullable": true,
                "type": "string"
              },
              "input_restrictions": {
                "example": [
                  "task"
                ],
                "items": {
                  "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                  "enum": [
                    "task",
                    "project",
                    "portfolio",
                    "goal"
                  ],
                  "type": "string"
                },
                "type": "array"
              },
              "is_formula_field": {
                "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                "example": false,
                "type": "boolean"
              },
              "is_lookup_field": {
                "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                "example": false,
                "type": "boolean"
              },
              "multi_enum_values": {
                "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                "items": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                  "properties": {
                    "color": {
                      "description": "The color of the enum option. Defaults to `none`.",
                      "example": "blue",
                      "type": "string"
                    },
                    "enabled": {
                      "description": "Whether or not the enum option is a selectable value for the custom field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the enum option.",
                      "example": "Low",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "enum_option"
                  }
                },
                "type": "array"
              },
              "name": {
                "description": "The name of the custom field.",
                "example": "Status",
                "type": "string"
              },
              "number_value": {
                "description": "*Conditional*. This number is the value of a `number` custom field.",
                "example": 5.2,
                "nullable": true,
                "type": "number"
              },
              "representation_type": {
                "description": "This field tells the type of the custom field.",
                "enum": [
                  "text",
                  "enum",
                  "multi_enum",
                  "number",
                  "date",
                  "people",
                  "formula",
                  "custom_id",
                  "reference"
                ],
                "example": "number",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              },
              "text_value": {
                "description": "*Conditional*. This string is the value of a `text` custom field.",
                "example": "Some Value",
                "nullable": true,
                "type": "string"
              },
              "type": {
                "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                "enum": [
                  "text",
                  "enum",
                  "multi_enum",
                  "number",
                  "date",
                  "people",
                  "reference"
                ],
                "readOnly": true,
                "type": "string"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "custom_field"
            }
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "is_important": {
            "description": "`is_important` is used in the Asana web application to determine if this custom field is displayed in the list/grid view of a table.",
            "readOnly": true,
            "type": "boolean"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "custom_field_setting"
        }
      },
      "sdk__CustomFieldTableSettingResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__CustomFieldTableSettingResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__CustomFieldTableSettingResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__CustomFieldTableSettingResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__CustomTypeBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Types extend the types of Asana Objects.",
        "properties": {
          "asana_created_type_identifier": {
            "description": "*Read-only*. A stable identifier present when this custom type was created by Asana as part of an Asana product (for example, a Command ticket type or a Service queue type). `null` for custom types created by users, and for Asana-created types that do not have a public identifier yet. New values may be added over time as Asana products introduce new types; integrations should tolerate unrecognized values.",
            "enum": [
              "COMMAND_TICKET",
              "COMMAND_RELEASE",
              "COMMAND_TEAMSPACE",
              "SERVICE_TICKET",
              "SERVICE_CONVERSATION",
              "SERVICE_QUEUE"
            ],
            "example": "COMMAND_TICKET",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the custom type.",
            "example": "Bug ticket",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "custom_type"
        }
      },
      "sdk__CustomTypeCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Types extend the types of Asana Objects.",
        "properties": {
          "asana_created_type_identifier": {
            "description": "*Read-only*. A stable identifier present when this custom type was created by Asana as part of an Asana product (for example, a Command ticket type or a Service queue type). `null` for custom types created by users, and for Asana-created types that do not have a public identifier yet. New values may be added over time as Asana products introduce new types; integrations should tolerate unrecognized values.",
            "enum": [
              "COMMAND_TICKET",
              "COMMAND_RELEASE",
              "COMMAND_TEAMSPACE",
              "SERVICE_TICKET",
              "SERVICE_CONVERSATION",
              "SERVICE_QUEUE"
            ],
            "example": "COMMAND_TICKET",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the custom type.",
            "example": "Bug ticket",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "custom_type"
        }
      },
      "sdk__CustomTypeMembershipBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object describes a user or team's membership to a custom type including their level of access (Admin, Editor, User, or Viewer).",
        "properties": {
          "access_level": {
            "description": "Whether the member has admin, editor, user, or viewer access to the custom type.",
            "enum": [
              "admin",
              "editor",
              "user",
              "viewer"
            ],
            "example": "admin",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the member",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of the member (team or user)",
                "example": "user",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "member"
            }
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Types extend the types of Asana Objects.",
            "properties": {
              "asana_created_type_identifier": {
                "description": "*Read-only*. A stable identifier present when this custom type was created by Asana as part of an Asana product (for example, a Command ticket type or a Service queue type). `null` for custom types created by users, and for Asana-created types that do not have a public identifier yet. New values may be added over time as Asana products introduce new types; integrations should tolerate unrecognized values.",
                "enum": [
                  "COMMAND_TICKET",
                  "COMMAND_RELEASE",
                  "COMMAND_TEAMSPACE",
                  "SERVICE_TICKET",
                  "SERVICE_CONVERSATION",
                  "SERVICE_QUEUE"
                ],
                "example": "COMMAND_TICKET",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the custom type.",
                "example": "Bug ticket",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "custom_type"
            }
          },
          "resource_subtype": {
            "description": "Type of the membership.",
            "example": "custom_type_membership",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "custom_type_membership"
        }
      },
      "sdk__CustomTypeMembershipCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object describes a user or team's membership to a custom type including their level of access (Admin, Editor, User, or Viewer).",
        "properties": {
          "access_level": {
            "description": "Whether the member has admin, editor, user, or viewer access to the custom type.",
            "enum": [
              "admin",
              "editor",
              "user",
              "viewer"
            ],
            "example": "admin",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the member",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of the member (team or user)",
                "example": "user",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "member"
            }
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Types extend the types of Asana Objects.",
            "properties": {
              "asana_created_type_identifier": {
                "description": "*Read-only*. A stable identifier present when this custom type was created by Asana as part of an Asana product (for example, a Command ticket type or a Service queue type). `null` for custom types created by users, and for Asana-created types that do not have a public identifier yet. New values may be added over time as Asana products introduce new types; integrations should tolerate unrecognized values.",
                "enum": [
                  "COMMAND_TICKET",
                  "COMMAND_RELEASE",
                  "COMMAND_TEAMSPACE",
                  "SERVICE_TICKET",
                  "SERVICE_CONVERSATION",
                  "SERVICE_QUEUE"
                ],
                "example": "COMMAND_TICKET",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the custom type.",
                "example": "Bug ticket",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "custom_type"
            }
          },
          "resource_subtype": {
            "description": "Type of the membership.",
            "example": "custom_type_membership",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "custom_type_membership"
        }
      },
      "sdk__CustomTypeMembershipResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object describes a user or team's membership to a custom type including their level of access (Admin, Editor, User, or Viewer).",
        "properties": {
          "access_level": {
            "description": "Whether the member has admin, editor, user, or viewer access to the custom type.",
            "enum": [
              "admin",
              "editor",
              "user",
              "viewer"
            ],
            "example": "admin",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the member",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of the member (team or user)",
                "example": "user",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "member"
            }
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Types extend the types of Asana Objects.",
            "properties": {
              "asana_created_type_identifier": {
                "description": "*Read-only*. A stable identifier present when this custom type was created by Asana as part of an Asana product (for example, a Command ticket type or a Service queue type). `null` for custom types created by users, and for Asana-created types that do not have a public identifier yet. New values may be added over time as Asana products introduce new types; integrations should tolerate unrecognized values.",
                "enum": [
                  "COMMAND_TICKET",
                  "COMMAND_RELEASE",
                  "COMMAND_TEAMSPACE",
                  "SERVICE_TICKET",
                  "SERVICE_CONVERSATION",
                  "SERVICE_QUEUE"
                ],
                "example": "COMMAND_TICKET",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the custom type.",
                "example": "Bug ticket",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "custom_type"
            }
          },
          "resource_subtype": {
            "description": "Type of the membership.",
            "example": "custom_type_membership",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "custom_type_membership"
        }
      },
      "sdk__CustomTypeResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Types extend the types of Asana Objects.",
        "properties": {
          "asana_created_type_identifier": {
            "description": "*Read-only*. A stable identifier present when this custom type was created by Asana as part of an Asana product (for example, a Command ticket type or a Service queue type). `null` for custom types created by users, and for Asana-created types that do not have a public identifier yet. New values may be added over time as Asana products introduce new types; integrations should tolerate unrecognized values.",
            "enum": [
              "COMMAND_TICKET",
              "COMMAND_RELEASE",
              "COMMAND_TEAMSPACE",
              "SERVICE_TICKET",
              "SERVICE_CONVERSATION",
              "SERVICE_QUEUE"
            ],
            "example": "COMMAND_TICKET",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the custom type.",
            "example": "Bug ticket",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "status_options": {
            "description": "The available options for the custom type.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.",
              "properties": {
                "color": {
                  "description": "The color associated with the custom type status option. Defaults to ‘none’.",
                  "example": "blue",
                  "nullable": true,
                  "type": "string"
                },
                "completion_state": {
                  "description": "The completion state the custom type status option corresponds to, all custom types must have one ‘Incomplete’ and ‘Complete’ status option.",
                  "example": "Incomplete",
                  "nullable": true,
                  "type": "string"
                },
                "enabled": {
                  "description": "Whether or not the custom type status option is a selectable value for the custom type.",
                  "example": true,
                  "nullable": true,
                  "type": "boolean"
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "The name of the custom type status option.",
                  "example": "Solution pending",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "custom_type_status_option"
              }
            },
            "nullable": true,
            "type": "array"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "custom_type"
        }
      },
      "sdk__CustomTypeResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__CustomTypeResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__CustomTypeResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__CustomTypeResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__CustomTypeStatusOptionBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the custom type status option.",
            "example": "Solution pending",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "custom_type_status_option"
        }
      },
      "sdk__CustomTypeStatusOptionCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the custom type status option.",
            "example": "Solution pending",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "custom_type_status_option"
        }
      },
      "sdk__CustomTypeStatusOptionResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "color": {
            "description": "The color associated with the custom type status option. Defaults to ‘none’.",
            "example": "blue",
            "nullable": true,
            "type": "string"
          },
          "completion_state": {
            "description": "The completion state the custom type status option corresponds to, all custom types must have one ‘Incomplete’ and ‘Complete’ status option.",
            "example": "Incomplete",
            "nullable": true,
            "type": "string"
          },
          "enabled": {
            "description": "Whether or not the custom type status option is a selectable value for the custom type.",
            "example": true,
            "nullable": true,
            "type": "boolean"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the custom type status option.",
            "example": "Solution pending",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "custom_type_status_option"
        }
      },
      "sdk__DateVariableCompact": {
        "properties": {
          "description": {
            "description": "The description of what the date variable is used for when instantiating a project.",
            "example": "Choose a start date for your project.",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the date field in the project template. A value of `1` refers to the project start date, while `2` refers to the project due date.",
            "example": "1",
            "readOnly": true,
            "type": "string"
          },
          "name": {
            "description": "The name of the date variable.",
            "example": "Start Date",
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__DateVariableRequest": {
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the date field in the project template. A value of `1` refers to the project start date, while `2` refers to the project due date.",
            "example": "1",
            "type": "string"
          },
          "value": {
            "description": "The date with which the date variable should be replaced when instantiating a project. This takes a date with `YYYY-MM-DD` format.",
            "example": "2022-01-01",
            "format": "date-time",
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__DeprecatedPortfolioMembershipBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object determines if a user is a member of a portfolio.",
        "properties": {
          "access_level": {
            "description": "Whether the member has admin, editor, or viewer access to the portfolio. Portfolios do not support commenter access yet.",
            "enum": [
              "admin",
              "editor",
              "viewer"
            ],
            "example": "admin",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "portfolio": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *portfolio* gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent [project status](/reference/project-statuses) update.\nPortfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the portfolio.",
                "example": "Bug Portfolio",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_portfolio",
                  "custom"
                ],
                "example": "default_portfolio",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "portfolio"
            }
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "user": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "portfolio_membership"
        }
      },
      "sdk__DeprecatedPortfolioMembershipCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object determines if a user is a member of a portfolio.",
        "properties": {
          "access_level": {
            "description": "Whether the member has admin, editor, or viewer access to the portfolio. Portfolios do not support commenter access yet.",
            "enum": [
              "admin",
              "editor",
              "viewer"
            ],
            "example": "admin",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "portfolio": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *portfolio* gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent [project status](/reference/project-statuses) update.\nPortfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the portfolio.",
                "example": "Bug Portfolio",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_portfolio",
                  "custom"
                ],
                "example": "default_portfolio",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "portfolio"
            }
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "user": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "portfolio_membership"
        }
      },
      "sdk__DeprecatedPortfolioMembershipResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object determines if a user is a member of a portfolio.",
        "properties": {
          "access_level": {
            "description": "Whether the member has admin, editor, or viewer access to the portfolio. Portfolios do not support commenter access yet.",
            "enum": [
              "admin",
              "editor",
              "viewer"
            ],
            "example": "admin",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "portfolio": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *portfolio* gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent [project status](/reference/project-statuses) update.\nPortfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the portfolio.",
                "example": "Bug Portfolio",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_portfolio",
                  "custom"
                ],
                "example": "default_portfolio",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "portfolio"
            }
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "user": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "portfolio_membership"
        }
      },
      "sdk__DeprecatedPortfolioMembershipResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__DeprecatedPortfolioMembershipResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__DeprecatedPortfolioMembershipResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__DeprecatedPortfolioMembershipResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__EffectiveTaskMembership": {
        "allOf": [
          {
            "properties": {
              "project": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "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.",
                    "example": "Stuff to buy",
                    "type": "string"
                  },
                  "resource_subtype": {
                    "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                    "enum": [
                      "default_project",
                      "custom"
                    ],
                    "example": "default_project",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "project"
                }
              },
              "section": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *section* is a subdivision of a project that groups tasks together. It can either be a header above a list of tasks in a list view or a column in a board view of a project.",
                "nullable": true,
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the section (i.e. the text displayed as the section header).",
                    "example": "Next Actions",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "section"
                }
              }
            },
            "type": "object"
          },
          {
            "properties": {
              "is_inherited": {
                "description": "Whether this membership is inherited from an ancestor task (`true`) or is a direct membership (`false`).",
                "example": false,
                "type": "boolean"
              }
            },
            "type": "object"
          }
        ],
        "description": "A task's project membership, indicating whether the membership is direct or inherited from an ancestor task."
      },
      "sdk__EmptyResponse": {
        "description": "An empty object. Some endpoints do not return an object on success. The success is conveyed through a 2-- status code and returning an empty object.",
        "type": "object"
      },
      "sdk__EmptyResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__EmptyResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__EnumOption": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
        "properties": {
          "color": {
            "description": "The color of the enum option. Defaults to `none`.",
            "example": "blue",
            "type": "string"
          },
          "enabled": {
            "description": "Whether or not the enum option is a selectable value for the custom field.",
            "example": true,
            "type": "boolean"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the enum option.",
            "example": "Low",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "enum_option"
        }
      },
      "sdk__EnumOptionBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
        "properties": {
          "color": {
            "description": "The color of the enum option. Defaults to `none`.",
            "example": "blue",
            "type": "string"
          },
          "enabled": {
            "description": "Whether or not the enum option is a selectable value for the custom field.",
            "example": true,
            "type": "boolean"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the enum option.",
            "example": "Low",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "enum_option"
        }
      },
      "sdk__EnumOptionData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__EnumOption"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__EnumOptionInsertRequest": {
        "properties": {
          "after_enum_option": {
            "description": "An existing enum option within this custom field after which the new enum option should be inserted. Cannot be provided together with before_enum_option.",
            "example": "12345",
            "type": "string"
          },
          "before_enum_option": {
            "description": "An existing enum option within this custom field before which the new enum option should be inserted. Cannot be provided together with after_enum_option.",
            "example": "12345",
            "type": "string"
          },
          "enum_option": {
            "description": "The gid of the enum option to relocate.",
            "example": "97285",
            "type": "string"
          }
        },
        "required": [
          "enum_option"
        ],
        "type": "object"
      },
      "sdk__EnumOptionRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
        "properties": {
          "color": {
            "description": "The color of the enum option. Defaults to `none`.",
            "example": "blue",
            "type": "string"
          },
          "enabled": {
            "description": "Whether or not the enum option is a selectable value for the custom field.",
            "example": true,
            "type": "boolean"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "insert_after": {
            "description": "An existing enum option within this custom field after which the new enum option should be inserted. Cannot be provided together with before_enum_option.",
            "example": "12345",
            "type": "string"
          },
          "insert_before": {
            "description": "An existing enum option within this custom field before which the new enum option should be inserted. Cannot be provided together with after_enum_option.",
            "example": "12345",
            "type": "string"
          },
          "name": {
            "description": "The name of the enum option.",
            "example": "Low",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "enum_option"
        }
      },
      "sdk__Error": {
        "properties": {
          "help": {
            "description": "Additional information directing developers to resources on how to address and fix the problem, if available.",
            "example": "For more information on API status codes and how to handle them, read the docs on errors: https://asana.github.io/developer-docs/#errors'",
            "readOnly": true,
            "type": "string"
          },
          "message": {
            "description": "Message providing more detail about the error that occurred, if available.",
            "example": "project: Missing input",
            "readOnly": true,
            "type": "string"
          },
          "phrase": {
            "description": "*500 errors only*. A unique error phrase which can be used when contacting developer support to help identify the exact occurrence of the problem in Asana's logs.",
            "example": "6 sad squid snuggle softly",
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__ErrorResponse": {
        "description": "Sadly, sometimes requests to the API are not successful. Failures can\noccur for a wide range of reasons. In all cases, the API should return\nan HTTP Status Code that indicates the nature of the failure,\nwith a response body in JSON format containing additional information.\n\n\nIn the event of a server error the response body will contain an error\nphrase. These phrases are automatically generated using the\n[node-asana-phrase\nlibrary](https://github.com/Asana/node-asana-phrase) and can be used by\nAsana support to quickly look up the incident that caused the server\nerror.",
        "properties": {
          "errors": {
            "items": {
              "properties": {
                "help": {
                  "description": "Additional information directing developers to resources on how to address and fix the problem, if available.",
                  "example": "For more information on API status codes and how to handle them, read the docs on errors: https://asana.github.io/developer-docs/#errors'",
                  "readOnly": true,
                  "type": "string"
                },
                "message": {
                  "description": "Message providing more detail about the error that occurred, if available.",
                  "example": "project: Missing input",
                  "readOnly": true,
                  "type": "string"
                },
                "phrase": {
                  "description": "*500 errors only*. A unique error phrase which can be used when contacting developer support to help identify the exact occurrence of the problem in Asana's logs.",
                  "example": "6 sad squid snuggle softly",
                  "readOnly": true,
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "sdk__EventResponse": {
        "description": "An *event* is an object representing a change to a resource that was\nobserved by an event subscription or delivered asynchronously to\nthe target location of an active webhook.\n\nThe event may be triggered by a different `user` than the\nsubscriber. For example, if user A subscribes to a task and user B\nmodified it, the event's user will be user B. Note: Some events\nare generated by the system, and will have `null` as the user. API\nconsumers should make sure to handle this case.\n\nThe `resource` that triggered the event may be different from the one\nthat the events were requested for or the webhook is subscribed to. For\nexample, a subscription to a project will contain events for tasks\ncontained within the project.\n\n**Note:** pay close attention to the relationship between the fields\n`Event.action` and `Event.change.action`.\n`Event.action` represents the action taken on the resource\nitself, and `Event.change.action` represents how the information\nwithin the resource's fields have been modified.\n\nFor instance, consider these scenarios:\n\n\n* When at task is added to a project, `Event.action` will be\n`added`, `Event.parent` will be an object with the `id` and\n`type` of the project, and there will be no `change` field.\n\n\n* When an assignee is set on the task, `Event.parent` will be\n`null`, `Event.action` will be `changed`,\n`Event.change.action` will be `changed`, and `new_value` will\nbe an object with the user's `id` and `type`.\n\n\n* When a collaborator is added to the task, `Event.parent` will\nbe `null`, `Event.action` will be `changed`,\n`Event.change.action` will be `added`, and `added_value` will be\nan object with the user's `id` and `type`.",
        "properties": {
          "action": {
            "description": "The type of action taken on the **resource** that triggered the event.  This can be one of `changed`, `added`, `removed`, `deleted`, or `undeleted` depending on the nature of the event.",
            "example": "changed",
            "readOnly": true,
            "type": "string"
          },
          "change": {
            "description": "Information about the type of change that has occurred. This field is only present when the value of the property `action`, describing the action taken on the **resource**, is `changed`.",
            "properties": {
              "action": {
                "description": "The type of action taken on the **field** which has been changed.  This can be one of `changed`, `added`, or `removed` depending on the nature of the change.",
                "example": "changed",
                "readOnly": true,
                "type": "string"
              },
              "added_value": {
                "description": "*Conditional.* This property is only present when the value of the event's `change.action` is `added` _and_ the `added_value` is an Asana resource. This will be only the `gid` and `resource_type` of the resource when the events come from webhooks; this will be the compact representation (and can have fields expanded with [opt_fields](/docs/inputoutput-options)) when using the [get events](/reference/getevents) endpoint.",
                "example": {
                  "gid": "12345",
                  "resource_type": "user"
                }
              },
              "field": {
                "description": "The name of the field that has changed in the resource.",
                "example": "assignee",
                "readOnly": true,
                "type": "string"
              },
              "new_value": {
                "description": "*Conditional.* This property is only present when the value of the event's `change.action` is `changed` _and_ the `new_value` is an Asana resource. This will be only the `gid` and `resource_type` of the resource when the events come from webhooks; this will be the compact representation (and can have fields expanded with [opt_fields](/docs/inputoutput-options)) when using the [get events](/reference/getevents) endpoint.",
                "example": {
                  "gid": "12345",
                  "resource_type": "user"
                }
              },
              "removed_value": {
                "description": "*Conditional.* This property is only present when the value of the event's `change.action` is `removed` _and_ the `removed_value` is an Asana resource. This will be only the `gid` and `resource_type` of the resource when the events come from webhooks; this will be the compact representation (and can have fields expanded with [opt_fields](/docs/inputoutput-options)) when using the [get events](/reference/getevents) endpoint.",
                "example": {
                  "gid": "12345",
                  "resource_type": "user"
                }
              }
            },
            "readOnly": true,
            "type": "object"
          },
          "created_at": {
            "description": "The timestamp when the event occurred.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nFor added/removed events, the parent object that resource was added to or removed from. The parent will be `null` for other event types.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the object.",
                "example": "Bug Task",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object"
          },
          "resource": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe resource which has triggered the event by being modified in some way.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the object.",
                "example": "Bug Task",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object"
          },
          "type": {
            "description": "*Deprecated: Refer to the resource_type of the resource.* The type of the resource that generated the event.",
            "example": "task",
            "readOnly": true,
            "type": "string"
          },
          "user": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.\nThe user who triggered the event.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          }
        },
        "type": "object"
      },
      "sdk__EventResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__EventResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__GoalAddSubgoalRequest": {
        "properties": {
          "insert_after": {
            "description": "An id of a subgoal of this parent goal. The new subgoal will be added after the one specified here. `insert_before` and `insert_after` parameters cannot both be specified.",
            "example": "1331",
            "type": "string"
          },
          "insert_before": {
            "description": "An id of a subgoal of this parent goal. The new subgoal will be added before the one specified here. `insert_before` and `insert_after` parameters cannot both be specified.",
            "example": "1331",
            "type": "string"
          },
          "subgoal": {
            "description": "The goal gid to add as subgoal to a parent goal",
            "example": "1331",
            "type": "string"
          }
        },
        "required": [
          "subgoal"
        ],
        "type": "object"
      },
      "sdk__GoalAddSupportingRelationshipRequest": {
        "properties": {
          "contribution_weight": {
            "description": "Defines how much the supporting goal’s progress contributes to the parent goal’s overall progress. When used with automatically calculated [Goal Metrics](/reference/creategoalmetric) (such as `progress_source = subgoal_progress`), this value must be greater than 0 for the subgoal to count toward the parent goal’s progress.\nAccepts a number between 0 and 1 (inclusive). Defaults to `0`.",
            "example": 0,
            "type": "number"
          },
          "insert_after": {
            "description": "An id of a subgoal of this parent goal. The new subgoal will be added after the one specified here. `insert_before` and `insert_after` parameters cannot both be specified. Currently only supported when adding a subgoal.",
            "example": "1331",
            "type": "string"
          },
          "insert_before": {
            "description": "An id of a subgoal of this parent goal. The new subgoal will be added before the one specified here. `insert_before` and `insert_after` parameters cannot both be specified. Currently only supported when adding a subgoal.",
            "example": "1331",
            "type": "string"
          },
          "supporting_resource": {
            "description": "The gid of the supporting resource to add to the parent goal. Must be the gid of a goal, project, task, or portfolio.",
            "example": "12345",
            "type": "string"
          }
        },
        "required": [
          "supporting_resource"
        ],
        "type": "object"
      },
      "sdk__GoalAddSupportingWorkRequest": {
        "properties": {
          "supporting_work": {
            "description": "The project/task/portfolio gid to add as supporting work for a goal",
            "example": "1331",
            "type": "string"
          }
        },
        "required": [
          "supporting_work"
        ],
        "type": "object"
      },
      "sdk__GoalBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "due_on": {
            "description": "The localized day on which this goal is due. This takes a date with format `YYYY-MM-DD`.",
            "example": "2019-09-15",
            "nullable": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_notes": {
            "description": "The notes of the goal with formatting as HTML. See [rich text](/docs/rich-text).",
            "example": "<body>Start building brand awareness.</body>",
            "type": "string"
          },
          "is_workspace_level": {
            "description": "*Conditional*. This property is only present when the `workspace` provided is an organization. Whether the goal belongs to the `workspace` (and is listed as part of the workspace’s goals) or not. If it isn’t a workspace-level goal, it is a team-level goal, and is associated with the goal’s team.",
            "example": true,
            "type": "boolean"
          },
          "liked": {
            "description": "True if the goal is liked by the authorized user, false if not.",
            "example": false,
            "type": "boolean"
          },
          "name": {
            "description": "The name of the goal.",
            "example": "Grow web traffic by 30%",
            "type": "string"
          },
          "notes": {
            "description": "Free-form textual information associated with the goal (i.e. its description).",
            "example": "Start building brand awareness.",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_on": {
            "description": "The day on which work for this goal begins, or null if the goal has no start date. This takes a date with `YYYY-MM-DD` format, and cannot be set unless there is an accompanying due date.",
            "example": "2019-09-14",
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "goal"
        }
      },
      "sdk__GoalCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the goal.",
            "example": "Grow web traffic by 30%",
            "type": "string"
          },
          "owner": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "goal"
        }
      },
      "sdk__GoalMembershipBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object represents a user's connection to a goal.",
        "properties": {
          "access_level": {
            "description": "\"Describes the membership access level for the goal. This is preferred over role.\"",
            "enum": [
              "viewer",
              "commenter",
              "editor",
              "admin"
            ],
            "example": "editor",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "goal": {
            "deprecated": true,
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\n*Deprecated: new integrations should prefer the `parent` field.* A *Goal* is an object in the goal-tracking system that helps your organization drive measurable results.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the goal.",
                "example": "Grow web traffic by 30%",
                "type": "string"
              },
              "owner": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "nullable": true,
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "goal"
            }
          },
          "member": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the member",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of the member (team or user)",
                "example": "user",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "member"
            }
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the goal.",
                "example": "Grow web traffic by 30%",
                "type": "string"
              },
              "owner": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "nullable": true,
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "goal"
            }
          },
          "resource_subtype": {
            "description": "The type of membership.",
            "example": "goal_membership",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "membership",
            "type": "string"
          },
          "role": {
            "deprecated": true,
            "description": "*Deprecated: Describes if the member is a commenter or editor in goal.*",
            "enum": [
              "commenter",
              "editor"
            ],
            "example": "editor",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "membership"
        }
      },
      "sdk__GoalMembershipCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object represents a user's connection to a goal.",
        "properties": {
          "access_level": {
            "description": "\"Describes the membership access level for the goal. This is preferred over role.\"",
            "enum": [
              "viewer",
              "commenter",
              "editor",
              "admin"
            ],
            "example": "editor",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "goal": {
            "deprecated": true,
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\n*Deprecated: new integrations should prefer the `parent` field.* A *Goal* is an object in the goal-tracking system that helps your organization drive measurable results.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the goal.",
                "example": "Grow web traffic by 30%",
                "type": "string"
              },
              "owner": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "nullable": true,
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "goal"
            }
          },
          "is_commenter": {
            "deprecated": true,
            "description": "*Deprecated: new integrations should prefer the `access_level` field.* Describes if the member is comment only in goal. This field is deprecated and will always be null.",
            "example": false,
            "readOnly": true,
            "type": "boolean"
          },
          "is_editor": {
            "deprecated": true,
            "description": "*Deprecated: new integrations should prefer the `access_level` field.* Describes if the member is editor in goal. This field is deprecated and will always be null.",
            "example": false,
            "readOnly": true,
            "type": "boolean"
          },
          "member": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the member",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of the member (team or user)",
                "example": "user",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "member"
            }
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the goal.",
                "example": "Grow web traffic by 30%",
                "type": "string"
              },
              "owner": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "nullable": true,
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "goal"
            }
          },
          "resource_subtype": {
            "description": "The type of membership.",
            "example": "goal_membership",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "membership",
            "type": "string"
          },
          "role": {
            "deprecated": true,
            "description": "*Deprecated: Describes if the member is a commenter or editor in goal.*",
            "enum": [
              "commenter",
              "editor"
            ],
            "example": "editor",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "membership"
        }
      },
      "sdk__GoalMembershipResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object represents a user's connection to a goal.",
        "properties": {
          "access_level": {
            "description": "\"Describes the membership access level for the goal. This is preferred over role.\"",
            "enum": [
              "viewer",
              "commenter",
              "editor",
              "admin"
            ],
            "example": "editor",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "goal": {
            "deprecated": true,
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\n*Deprecated: new integrations should prefer the `parent` field.* A *Goal* is an object in the goal-tracking system that helps your organization drive measurable results.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the goal.",
                "example": "Grow web traffic by 30%",
                "type": "string"
              },
              "owner": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "nullable": true,
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "goal"
            }
          },
          "member": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the member",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of the member (team or user)",
                "example": "user",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "member"
            }
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the goal.",
                "example": "Grow web traffic by 30%",
                "type": "string"
              },
              "owner": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "nullable": true,
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "goal"
            }
          },
          "resource_subtype": {
            "description": "The type of membership.",
            "example": "goal_membership",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "membership",
            "type": "string"
          },
          "role": {
            "deprecated": true,
            "description": "*Deprecated: Describes if the member is a commenter or editor in goal.*",
            "enum": [
              "commenter",
              "editor"
            ],
            "example": "editor",
            "type": "string"
          },
          "user": {
            "deprecated": true,
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.\n*Deprecated: new integrations should prefer the `member` field.* A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "workspace": {
            "deprecated": true,
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.\n*Deprecated:* A *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the workspace.",
                "example": "My Company Workspace",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "workspace"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "membership"
        }
      },
      "sdk__GoalMetricBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "currency_code": {
            "description": "ISO 4217 currency code to format this custom field. This will be null if the `unit` is not `currency`.",
            "example": "EUR",
            "nullable": true,
            "type": "string"
          },
          "current_display_value": {
            "description": "This string is the current value of a goal metric of type string.",
            "example": "8.12",
            "readOnly": true,
            "type": "string"
          },
          "current_number_value": {
            "description": "This number is the current value of a goal metric of type number.",
            "example": 8.12,
            "type": "number"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "initial_number_value": {
            "description": "This number is the start value of a goal metric of type number.",
            "example": 5.2,
            "type": "number"
          },
          "is_custom_weight": {
            "description": "*Conditional*. Only relevant if `metric.progress_source` is one of `subgoal_progress`, `project_task_completion`, `project_milestone_completion`, or `task_completion`. If true, we use the supporting object's custom weight to calculate the goal's progress. If false, we treat all supporting objects as equally weighted",
            "example": false,
            "type": "boolean"
          },
          "precision": {
            "description": "*Conditional*. Only relevant for goal metrics of type `Number`. This field dictates the number of places after the decimal to round to, i.e. 0 is integer values, 1 rounds to the nearest tenth, and so on. Must be between 0 and 6, inclusive.\nFor percentage format, this may be unintuitive, as a value of 0.25 has a precision of 0, while a value of 0.251 has a precision of 1. This is due to 0.25 being displayed as 25%.",
            "example": 2,
            "type": "integer"
          },
          "progress_source": {
            "description": "This field defines how the progress value of a goal metric is being calculated. A goal's progress can be provided manually by the user, calculated automatically from contributing subgoals, projects, or tasks, or managed by an integration with an external data source, such as Salesforce.",
            "enum": [
              "manual",
              "subgoal_progress",
              "project_task_completion",
              "project_milestone_completion",
              "task_completion",
              "external"
            ],
            "example": "manual",
            "type": "string"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "enum": [
              "number"
            ],
            "example": "number",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "target_number_value": {
            "description": "This number is the end value of a goal metric of type number. This number cannot equal `initial_number_value`.",
            "example": 10.2,
            "type": "number"
          },
          "unit": {
            "description": "A supported unit of measure for the goal metric, or none.",
            "enum": [
              "none",
              "currency",
              "percentage"
            ],
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__GoalMetricCurrentValueRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "current_number_value": {
            "description": "*Conditional*. This number is the current value of a goal metric of type number.",
            "example": 8.12,
            "type": "number"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "sdk__GoalMetricRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "currency_code": {
            "description": "ISO 4217 currency code to format this custom field. This will be null if the `unit` is not `currency`.",
            "example": "EUR",
            "nullable": true,
            "type": "string"
          },
          "current_display_value": {
            "description": "This string is the current value of a goal metric of type string.",
            "example": "8.12",
            "readOnly": true,
            "type": "string"
          },
          "current_number_value": {
            "description": "This number is the current value of a goal metric of type number.",
            "example": 8.12,
            "type": "number"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "initial_number_value": {
            "description": "This number is the start value of a goal metric of type number.",
            "example": 5.2,
            "type": "number"
          },
          "is_custom_weight": {
            "description": "*Conditional*. Only relevant if `metric.progress_source` is one of `subgoal_progress`, `project_task_completion`, `project_milestone_completion`, or `task_completion`. If true, we use the supporting object's custom weight to calculate the goal's progress. If false, we treat all supporting objects as equally weighted",
            "example": false,
            "type": "boolean"
          },
          "precision": {
            "description": "*Conditional*. Only relevant for goal metrics of type `Number`. This field dictates the number of places after the decimal to round to, i.e. 0 is integer values, 1 rounds to the nearest tenth, and so on. Must be between 0 and 6, inclusive.\nFor percentage format, this may be unintuitive, as a value of 0.25 has a precision of 0, while a value of 0.251 has a precision of 1. This is due to 0.25 being displayed as 25%.",
            "example": 2,
            "type": "integer"
          },
          "progress_source": {
            "description": "This field defines how the progress value of a goal metric is being calculated. A goal's progress can be provided manually by the user, calculated automatically from contributing subgoals, projects, or tasks, or managed by an integration with an external data source, such as Salesforce.",
            "enum": [
              "manual",
              "subgoal_progress",
              "project_task_completion",
              "project_milestone_completion",
              "task_completion",
              "external"
            ],
            "example": "manual",
            "type": "string"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "enum": [
              "number"
            ],
            "example": "number",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "target_number_value": {
            "description": "This number is the end value of a goal metric of type number. This number cannot equal `initial_number_value`.",
            "example": 10.2,
            "type": "number"
          },
          "unit": {
            "description": "A supported unit of measure for the goal metric, or none.",
            "enum": [
              "none",
              "currency",
              "percentage"
            ],
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__GoalRelationshipBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *goal relationship* is an object representing the relationship between a goal and another goal, a project, a task, or a portfolio.",
        "properties": {
          "contribution_weight": {
            "description": "The weight that the supporting resource's progress contributes to the supported goal's progress. This can be 0, 1, or any value in between.",
            "example": 1,
            "type": "number"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "enum": [
              "subgoal",
              "supporting_work"
            ],
            "example": "subgoal",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "supported_goal": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe goal that the supporting resource supports.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the goal.",
                "example": "Grow web traffic by 30%",
                "type": "string"
              },
              "owner": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "nullable": true,
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "goal"
            }
          },
          "supporting_resource": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\nThe supporting resource that supports the goal. This can be either a project, task, portfolio, or goal.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "goal_relationship"
        }
      },
      "sdk__GoalRelationshipCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *goal relationship* is an object representing the relationship between a goal and another goal, a project, a task, or a portfolio.",
        "properties": {
          "contribution_weight": {
            "description": "The weight that the supporting resource's progress contributes to the supported goal's progress. This can be 0, 1, or any value in between.",
            "example": 1,
            "type": "number"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "enum": [
              "subgoal",
              "supporting_work"
            ],
            "example": "subgoal",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "supporting_resource": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\nThe supporting resource that supports the goal. This can be either a project, task, portfolio, or goal.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "goal_relationship"
        }
      },
      "sdk__GoalRelationshipRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *goal relationship* is an object representing the relationship between a goal and another goal, a project, a task, or a portfolio.",
        "properties": {
          "contribution_weight": {
            "description": "The weight that the supporting resource's progress contributes to the supported goal's progress. This can be 0, 1, or any value in between.",
            "example": 1,
            "type": "number"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "enum": [
              "subgoal",
              "supporting_work"
            ],
            "example": "subgoal",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "supported_goal": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe goal that the supporting resource supports.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the goal.",
                "example": "Grow web traffic by 30%",
                "type": "string"
              },
              "owner": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "nullable": true,
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "goal"
            }
          },
          "supporting_resource": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\nThe supporting resource that supports the goal. This can be either a project, task, portfolio, or goal.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "goal_relationship"
        }
      },
      "sdk__GoalRelationshipResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *goal relationship* is an object representing the relationship between a goal and another goal, a project, a task, or a portfolio.",
        "properties": {
          "contribution_weight": {
            "description": "The weight that the supporting resource's progress contributes to the supported goal's progress. This can be 0, 1, or any value in between.",
            "example": 1,
            "type": "number"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "enum": [
              "subgoal",
              "supporting_work"
            ],
            "example": "subgoal",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "supported_goal": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe goal that the supporting resource supports.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the goal.",
                "example": "Grow web traffic by 30%",
                "type": "string"
              },
              "owner": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "nullable": true,
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "goal"
            }
          },
          "supporting_resource": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\nThe supporting resource that supports the goal. This can be either a project, task, portfolio, or goal.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "goal_relationship"
        }
      },
      "sdk__GoalRelationshipResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__GoalRelationshipResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__GoalRelationshipResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__GoalRelationshipResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__GoalRemoveSubgoalRequest": {
        "properties": {
          "subgoal": {
            "description": "The goal gid to remove as subgoal from the parent goal",
            "example": "1331",
            "type": "string"
          }
        },
        "required": [
          "subgoal"
        ],
        "type": "object"
      },
      "sdk__GoalRemoveSupportingRelationshipRequest": {
        "properties": {
          "supporting_resource": {
            "description": "The gid of the supporting resource to remove from the parent goal. Must be the gid of a goal, project, task, or portfolio.",
            "example": "12345",
            "type": "string"
          }
        },
        "required": [
          "supporting_resource"
        ],
        "type": "object"
      },
      "sdk__GoalRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "due_on": {
            "description": "The localized day on which this goal is due. This takes a date with format `YYYY-MM-DD`.",
            "example": "2019-09-15",
            "nullable": true,
            "type": "string"
          },
          "followers": {
            "example": [
              "12345"
            ],
            "items": {
              "description": "The `gid` of a user.",
              "type": "string"
            },
            "type": "array"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_notes": {
            "description": "The notes of the goal with formatting as HTML. See [rich text](/docs/rich-text).",
            "example": "<body>Start building brand awareness.</body>",
            "type": "string"
          },
          "is_workspace_level": {
            "description": "*Conditional*. This property is only present when the `workspace` provided is an organization. Whether the goal belongs to the `workspace` (and is listed as part of the workspace’s goals) or not. If it isn’t a workspace-level goal, it is a team-level goal, and is associated with the goal’s team.",
            "example": true,
            "type": "boolean"
          },
          "liked": {
            "description": "True if the goal is liked by the authorized user, false if not.",
            "example": false,
            "type": "boolean"
          },
          "name": {
            "description": "The name of the goal.",
            "example": "Grow web traffic by 30%",
            "type": "string"
          },
          "notes": {
            "description": "Free-form textual information associated with the goal (i.e. its description).",
            "example": "Start building brand awareness.",
            "type": "string"
          },
          "owner": {
            "description": "The `gid` of a user.",
            "example": "12345",
            "nullable": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_on": {
            "description": "The day on which work for this goal begins, or null if the goal has no start date. This takes a date with `YYYY-MM-DD` format, and cannot be set unless there is an accompanying due date.",
            "example": "2019-09-14",
            "nullable": true,
            "type": "string"
          },
          "team": {
            "description": "*Conditional*. This property is only present when the `workspace` provided is an organization.",
            "example": "12345",
            "nullable": true,
            "type": "string"
          },
          "time_period": {
            "description": "The `gid` of a time period.",
            "example": "12345",
            "nullable": true,
            "type": "string"
          },
          "workspace": {
            "description": "The `gid` of a workspace.",
            "example": "12345",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "goal"
        }
      },
      "sdk__GoalRequestBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "due_on": {
            "description": "The localized day on which this goal is due. This takes a date with format `YYYY-MM-DD`.",
            "example": "2019-09-15",
            "nullable": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_notes": {
            "description": "The notes of the goal with formatting as HTML. See [rich text](/docs/rich-text).",
            "example": "<body>Start building brand awareness.</body>",
            "type": "string"
          },
          "is_workspace_level": {
            "description": "*Conditional*. This property is only present when the `workspace` provided is an organization. Whether the goal belongs to the `workspace` (and is listed as part of the workspace’s goals) or not. If it isn’t a workspace-level goal, it is a team-level goal, and is associated with the goal’s team.",
            "example": true,
            "type": "boolean"
          },
          "liked": {
            "description": "True if the goal is liked by the authorized user, false if not.",
            "example": false,
            "type": "boolean"
          },
          "name": {
            "description": "The name of the goal.",
            "example": "Grow web traffic by 30%",
            "type": "string"
          },
          "notes": {
            "description": "Free-form textual information associated with the goal (i.e. its description).",
            "example": "Start building brand awareness.",
            "type": "string"
          },
          "owner": {
            "description": "The `gid` of a user.",
            "example": "12345",
            "nullable": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_on": {
            "description": "The day on which work for this goal begins, or null if the goal has no start date. This takes a date with `YYYY-MM-DD` format, and cannot be set unless there is an accompanying due date.",
            "example": "2019-09-14",
            "nullable": true,
            "type": "string"
          },
          "team": {
            "description": "*Conditional*. This property is only present when the `workspace` provided is an organization.",
            "example": "12345",
            "nullable": true,
            "type": "string"
          },
          "time_period": {
            "description": "The `gid` of a time period.",
            "example": "12345",
            "nullable": true,
            "type": "string"
          },
          "workspace": {
            "description": "The `gid` of a workspace.",
            "example": "12345",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "goal"
        }
      },
      "sdk__GoalResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "current_status_update": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *status update* is an update on the progress of a particular project, portfolio, or goal, and is sent out to all of its parent's followers when created. These updates include both text describing the update and a `status_type` intended to represent the overall state of the object.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *status update* is an update on the progress of a particular project, portfolio, or goal, and is sent out to all of its parent's followers when created. These updates include both text describing the update and a `status_type` intended to represent the overall state of the object.\nThe latest `status_update` posted to this goal.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe `resource_subtype`s for `status` objects represent the type of their parent.",
                "enum": [
                  "project_status_update",
                  "portfolio_status_update",
                  "goal_status_update"
                ],
                "example": "project_status_update",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              },
              "title": {
                "description": "The title of the status update.",
                "example": "Status Update - Jun 15",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "status_update"
            }
          },
          "custom_field_settings": {
            "description": "Array of custom field definitions that are enabled for the goal. These represent which custom fields are available to be used on items within the goal, but do not include any values.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields Settings objects represent the many-to-many join of the Custom Field and Project as well as stores information that is relevant to that particular pairing.",
              "properties": {
                "custom_field": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.\nThe custom field that is applied to the `parent`.",
                  "properties": {
                    "asana_created_field": {
                      "description": "*Conditional*. A unique identifier to associate this field with the template source of truth.",
                      "enum": [
                        "a_v_requirements",
                        "account_name",
                        "actionable",
                        "align_shipping_link",
                        "align_status",
                        "allotted_time",
                        "appointment",
                        "approval_stage",
                        "approved",
                        "article_series",
                        "board_committee",
                        "browser",
                        "campaign_audience",
                        "campaign_project_status",
                        "campaign_regions",
                        "channel_primary",
                        "client_topic_type",
                        "complete_by",
                        "contact",
                        "contact_email_address",
                        "content_channels",
                        "content_channels_needed",
                        "content_stage",
                        "content_type",
                        "contract",
                        "contract_status",
                        "cost",
                        "creation_stage",
                        "creative_channel",
                        "creative_needed",
                        "creative_needs",
                        "data_sensitivity",
                        "deal_size",
                        "delivery_appt",
                        "delivery_appt_date",
                        "department",
                        "department_responsible",
                        "design_request_needed",
                        "design_request_type",
                        "discussion_category",
                        "do_this_task",
                        "editorial_content_status",
                        "editorial_content_tag",
                        "editorial_content_type",
                        "effort",
                        "effort_level",
                        "est_completion_date",
                        "estimated_time",
                        "estimated_value",
                        "expected_cost",
                        "external_steps_needed",
                        "favorite_idea",
                        "feedback_type",
                        "financial",
                        "funding_amount",
                        "grant_application_process",
                        "hiring_candidate_status",
                        "idea_status",
                        "ids_link",
                        "ids_patient_link",
                        "implementation_stage",
                        "insurance",
                        "interview_area",
                        "interview_question_score",
                        "itero_scan_link",
                        "job_s_applied_to",
                        "lab",
                        "launch_status",
                        "lead_status",
                        "localization_language",
                        "localization_market_team",
                        "localization_status",
                        "meeting_minutes",
                        "meeting_needed",
                        "minutes",
                        "mrr",
                        "must_localize",
                        "name_of_foundation",
                        "need_to_follow_up",
                        "next_appointment",
                        "next_steps_sales",
                        "num_people",
                        "number_of_user_reports",
                        "office_location",
                        "onboarding_activity",
                        "owner",
                        "participants_needed",
                        "patient_date_of_birth",
                        "patient_email",
                        "patient_phone",
                        "patient_status",
                        "phone_number",
                        "planning_category",
                        "point_of_contact",
                        "position",
                        "post_format",
                        "prescription",
                        "priority",
                        "priority_level",
                        "product",
                        "product_stage",
                        "progress",
                        "project_size",
                        "project_status",
                        "proposed_budget",
                        "publish_status",
                        "reason_for_scan",
                        "referral",
                        "request_type",
                        "research_status",
                        "responsible_department",
                        "responsible_team",
                        "risk_assessment_status",
                        "room_name",
                        "sales_counterpart",
                        "sentiment",
                        "shipping_link",
                        "social_channels",
                        "stage",
                        "status",
                        "status_design",
                        "status_of_initiative",
                        "system_setup",
                        "task_progress",
                        "team",
                        "team_marketing",
                        "team_responsible",
                        "time_it_takes_to_complete_tasks",
                        "timeframe",
                        "treatment_type",
                        "type_work_requests_it",
                        "use_agency",
                        "user_name",
                        "vendor_category",
                        "vendor_type",
                        "word_count",
                        null
                      ],
                      "example": "priority",
                      "nullable": true,
                      "readOnly": true,
                      "type": "string"
                    },
                    "created_by": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                      "nullable": true,
                      "properties": {
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "*Read-only except when same user as requester*. The user's name.",
                          "example": "Greg Sanchez",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "user"
                      }
                    },
                    "currency_code": {
                      "description": "ISO 4217 currency code to format this custom field. This will be null if the `format` is not `currency`.",
                      "example": "EUR",
                      "nullable": true,
                      "type": "string"
                    },
                    "custom_label": {
                      "description": "This is the string that appears next to the custom field value. This will be null if the `format` is not `custom`.",
                      "example": "gold pieces",
                      "nullable": true,
                      "type": "string"
                    },
                    "custom_label_position": {
                      "description": "Only relevant for custom fields with `custom` format. This depicts where to place the custom label. This will be null if the `format` is not `custom`.",
                      "enum": [
                        "prefix",
                        "suffix",
                        null
                      ],
                      "example": "suffix",
                      "nullable": true,
                      "type": "string"
                    },
                    "date_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                      "nullable": true,
                      "properties": {
                        "date": {
                          "description": "A string representing the date in YYYY-MM-DD format.",
                          "example": "2024-08-23",
                          "type": "string"
                        },
                        "date_time": {
                          "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                          "example": "2024-08-23T22:00:00.000Z",
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    "default_access_level": {
                      "description": "The default access level when inviting new members to the custom field. This isn't applied when the `privacy_setting` is `private`, or the user is a guest. For local fields in a project or portfolio, the user must additionally have permission to modify the container itself.",
                      "enum": [
                        "admin",
                        "editor",
                        "user"
                      ],
                      "example": "user",
                      "type": "string"
                    },
                    "description": {
                      "description": "[Opt In](/docs/inputoutput-options). The description of the custom field.",
                      "example": "Development team priority",
                      "type": "string"
                    },
                    "display_value": {
                      "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                      "example": "blue",
                      "nullable": true,
                      "readOnly": true,
                      "type": "string"
                    },
                    "enabled": {
                      "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                      "example": true,
                      "readOnly": true,
                      "type": "boolean"
                    },
                    "enum_options": {
                      "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                        "properties": {
                          "color": {
                            "description": "The color of the enum option. Defaults to `none`.",
                            "example": "blue",
                            "type": "string"
                          },
                          "enabled": {
                            "description": "Whether or not the enum option is a selectable value for the custom field.",
                            "example": true,
                            "type": "boolean"
                          },
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "The name of the enum option.",
                            "example": "Low",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object",
                        "x-docs-overrides": {
                          "properties.resource_type.example": "enum_option"
                        }
                      },
                      "type": "array"
                    },
                    "enum_value": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                      "nullable": true,
                      "properties": {
                        "color": {
                          "description": "The color of the enum option. Defaults to `none`.",
                          "example": "blue",
                          "type": "string"
                        },
                        "enabled": {
                          "description": "Whether or not the enum option is a selectable value for the custom field.",
                          "example": true,
                          "type": "boolean"
                        },
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "The name of the enum option.",
                          "example": "Low",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "enum_option"
                      }
                    },
                    "format": {
                      "description": "The format of this custom field.",
                      "enum": [
                        "currency",
                        "identifier",
                        "percentage",
                        "custom",
                        "duration",
                        "none"
                      ],
                      "example": "custom",
                      "type": "string"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "has_notifications_enabled": {
                      "description": "*Conditional*. This flag describes whether a follower of a task with this field should receive inbox notifications from changes to this field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "html_text_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `text`. This is the HTML representation of the text value of a custom field, corresponding to the `text_value` plain-text field. See [rich text](/docs/rich-text#reading-rich-text).",
                      "example": "<body>Some Value</body>",
                      "nullable": true,
                      "readOnly": true,
                      "type": "string"
                    },
                    "id_prefix": {
                      "description": "This field is the unique custom ID string for the custom field.",
                      "example": "ID",
                      "nullable": true,
                      "type": "string"
                    },
                    "input_restrictions": {
                      "example": [
                        "task"
                      ],
                      "items": {
                        "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                        "enum": [
                          "task",
                          "project",
                          "portfolio",
                          "goal"
                        ],
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "is_formula_field": {
                      "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                      "example": false,
                      "type": "boolean"
                    },
                    "is_global_to_workspace": {
                      "description": "This flag describes whether this custom field is available to every container in the workspace. Before project-specific custom fields, this field was always true.",
                      "example": true,
                      "readOnly": true,
                      "type": "boolean"
                    },
                    "is_lookup_field": {
                      "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                      "example": false,
                      "type": "boolean"
                    },
                    "is_value_read_only": {
                      "description": "*Conditional*. This flag describes whether a custom field is read only.",
                      "example": false,
                      "type": "boolean"
                    },
                    "multi_enum_values": {
                      "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                        "properties": {
                          "color": {
                            "description": "The color of the enum option. Defaults to `none`.",
                            "example": "blue",
                            "type": "string"
                          },
                          "enabled": {
                            "description": "Whether or not the enum option is a selectable value for the custom field.",
                            "example": true,
                            "type": "boolean"
                          },
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "The name of the enum option.",
                            "example": "Low",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object",
                        "x-docs-overrides": {
                          "properties.resource_type.example": "enum_option"
                        }
                      },
                      "type": "array"
                    },
                    "name": {
                      "description": "The name of the custom field.",
                      "example": "Status",
                      "type": "string"
                    },
                    "number_value": {
                      "description": "*Conditional*. This number is the value of a `number` custom field.",
                      "example": 5.2,
                      "nullable": true,
                      "type": "number"
                    },
                    "people_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `people`. This array of [compact user](/reference/users) objects reflects the values of a `people` custom field.",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                        "properties": {
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "*Read-only except when same user as requester*. The user's name.",
                            "example": "Greg Sanchez",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object",
                        "x-docs-overrides": {
                          "properties.resource_type.example": "user"
                        }
                      },
                      "type": "array"
                    },
                    "precision": {
                      "description": "Only relevant for custom fields of type `Number`. This field dictates the number of places after the decimal to round to, i.e. 0 is integer values, 1 rounds to the nearest tenth, and so on. Must be between 0 and 6, inclusive.\nFor percentage format, this may be unintuitive, as a value of 0.25 has a precision of 0, while a value of 0.251 has a precision of 1. This is due to 0.25 being displayed as 25%.\nThe identifier format will always have a precision of 0.",
                      "example": 2,
                      "type": "integer"
                    },
                    "privacy_setting": {
                      "description": "The privacy setting of the custom field. *Note: Administrators in your organization may restrict the values of `privacy_setting`.*",
                      "enum": [
                        "public_with_guests",
                        "public",
                        "private"
                      ],
                      "example": "public_with_guests",
                      "type": "string"
                    },
                    "reference_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of objects reflects the values of a `reference` custom field.",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.",
                        "properties": {
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "The name of the object.",
                            "example": "Bug Task",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "representation_type": {
                      "description": "This field tells the type of the custom field.",
                      "enum": [
                        "text",
                        "enum",
                        "multi_enum",
                        "number",
                        "date",
                        "people",
                        "formula",
                        "custom_id",
                        "reference"
                      ],
                      "example": "number",
                      "readOnly": true,
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The type of the custom field. Must be one of the given values.\n",
                      "enum": [
                        "text",
                        "enum",
                        "multi_enum",
                        "number",
                        "date",
                        "people",
                        "reference"
                      ],
                      "example": "text",
                      "readOnly": true,
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    },
                    "text_value": {
                      "description": "*Conditional*. This string is the value of a `text` custom field.",
                      "example": "Some Value",
                      "nullable": true,
                      "type": "string"
                    },
                    "type": {
                      "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                      "enum": [
                        "text",
                        "enum",
                        "multi_enum",
                        "number",
                        "date",
                        "people",
                        "reference"
                      ],
                      "readOnly": true,
                      "type": "string"
                    }
                  },
                  "readOnly": true,
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "custom_field"
                  }
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "is_important": {
                  "description": "`is_important` is used in the Asana web application to determine if this custom field is displayed in the list/grid view of a project or portfolio.",
                  "example": false,
                  "readOnly": true,
                  "type": "boolean"
                },
                "parent": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\nThe parent to which the custom field is applied. This can be a project or portfolio and indicates that the tasks or projects that the parent contains may be given custom field values for this custom field.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "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.",
                      "example": "Stuff to buy",
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                      "enum": [
                        "default_project",
                        "custom"
                      ],
                      "example": "default_project",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "readOnly": true,
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "project"
                  }
                },
                "project": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\n*Deprecated: new integrations should prefer the `parent` field.* The id of the project that this custom field settings refers to.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "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.",
                      "example": "Stuff to buy",
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                      "enum": [
                        "default_project",
                        "custom"
                      ],
                      "example": "default_project",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "readOnly": true,
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "project"
                  }
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "custom_field_setting"
              }
            },
            "type": "array"
          },
          "custom_fields": {
            "description": "Array of custom field values applied directly to the goal itself. These represent the values set on the goal, not the fields available for items in the goal.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.",
              "properties": {
                "date_value": {
                  "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                  "nullable": true,
                  "properties": {
                    "date": {
                      "description": "A string representing the date in YYYY-MM-DD format.",
                      "example": "2024-08-23",
                      "type": "string"
                    },
                    "date_time": {
                      "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                      "example": "2024-08-23T22:00:00.000Z",
                      "type": "string"
                    }
                  },
                  "type": "object"
                },
                "display_value": {
                  "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                  "example": "blue",
                  "nullable": true,
                  "readOnly": true,
                  "type": "string"
                },
                "enabled": {
                  "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                  "example": true,
                  "readOnly": true,
                  "type": "boolean"
                },
                "enum_options": {
                  "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                  "items": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                    "properties": {
                      "color": {
                        "description": "The color of the enum option. Defaults to `none`.",
                        "example": "blue",
                        "type": "string"
                      },
                      "enabled": {
                        "description": "Whether or not the enum option is a selectable value for the custom field.",
                        "example": true,
                        "type": "boolean"
                      },
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "The name of the enum option.",
                        "example": "Low",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "enum_option"
                    }
                  },
                  "type": "array"
                },
                "enum_value": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                  "nullable": true,
                  "properties": {
                    "color": {
                      "description": "The color of the enum option. Defaults to `none`.",
                      "example": "blue",
                      "type": "string"
                    },
                    "enabled": {
                      "description": "Whether or not the enum option is a selectable value for the custom field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the enum option.",
                      "example": "Low",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "enum_option"
                  }
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "id_prefix": {
                  "description": "This field is the unique custom ID string for the custom field.",
                  "example": "ID",
                  "nullable": true,
                  "type": "string"
                },
                "input_restrictions": {
                  "example": [
                    "task"
                  ],
                  "items": {
                    "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                    "enum": [
                      "task",
                      "project",
                      "portfolio",
                      "goal"
                    ],
                    "type": "string"
                  },
                  "type": "array"
                },
                "is_formula_field": {
                  "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                  "example": false,
                  "type": "boolean"
                },
                "is_lookup_field": {
                  "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                  "example": false,
                  "type": "boolean"
                },
                "multi_enum_values": {
                  "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                  "items": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                    "properties": {
                      "color": {
                        "description": "The color of the enum option. Defaults to `none`.",
                        "example": "blue",
                        "type": "string"
                      },
                      "enabled": {
                        "description": "Whether or not the enum option is a selectable value for the custom field.",
                        "example": true,
                        "type": "boolean"
                      },
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "The name of the enum option.",
                        "example": "Low",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "enum_option"
                    }
                  },
                  "type": "array"
                },
                "name": {
                  "description": "The name of the custom field.",
                  "example": "Status",
                  "type": "string"
                },
                "number_value": {
                  "description": "*Conditional*. This number is the value of a `number` custom field.",
                  "example": 5.2,
                  "nullable": true,
                  "type": "number"
                },
                "representation_type": {
                  "description": "This field tells the type of the custom field.",
                  "enum": [
                    "text",
                    "enum",
                    "multi_enum",
                    "number",
                    "date",
                    "people",
                    "formula",
                    "custom_id",
                    "reference"
                  ],
                  "example": "number",
                  "readOnly": true,
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                },
                "text_value": {
                  "description": "*Conditional*. This string is the value of a `text` custom field.",
                  "example": "Some Value",
                  "nullable": true,
                  "type": "string"
                },
                "type": {
                  "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                  "enum": [
                    "text",
                    "enum",
                    "multi_enum",
                    "number",
                    "date",
                    "people",
                    "reference"
                  ],
                  "readOnly": true,
                  "type": "string"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "custom_field"
              }
            },
            "type": "array"
          },
          "default_access_level": {
            "description": "The default access level when inviting new members to the goal",
            "enum": [
              "admin",
              "editor",
              "commenter",
              "viewer"
            ],
            "example": "editor",
            "type": "string"
          },
          "due_on": {
            "description": "The localized day on which this goal is due. This takes a date with format `YYYY-MM-DD`.",
            "example": "2019-09-15",
            "nullable": true,
            "type": "string"
          },
          "followers": {
            "description": "Array of users who are members of this goal.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "*Read-only except when same user as requester*. The user's name.",
                  "example": "Greg Sanchez",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "user"
              }
            },
            "type": "array"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_notes": {
            "description": "The notes of the goal with formatting as HTML. See [rich text](/docs/rich-text).",
            "example": "<body>Start building brand awareness.</body>",
            "type": "string"
          },
          "is_workspace_level": {
            "description": "*Conditional*. This property is only present when the `workspace` provided is an organization. Whether the goal belongs to the `workspace` (and is listed as part of the workspace’s goals) or not. If it isn’t a workspace-level goal, it is a team-level goal, and is associated with the goal’s team.",
            "example": true,
            "type": "boolean"
          },
          "liked": {
            "description": "True if the goal is liked by the authorized user, false if not.",
            "example": false,
            "type": "boolean"
          },
          "likes": {
            "description": "Array of likes for users who have liked this goal.",
            "items": {
              "description": "An object to represent a user's like.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the object, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string"
                },
                "user": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "*Read-only except when same user as requester*. The user's name.",
                      "example": "Greg Sanchez",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "user"
                  }
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "metric": {
            "description": "A generic Asana Resource, containing a globally unique identifier.",
            "nullable": true,
            "properties": {
              "can_manage": {
                "description": "*Conditional*. Only relevant for `progress_source` of type `external`. This boolean indicates whether the requester has the ability to update the current value of this metric. This returns `true` if the external metric was created by the requester, `false` otherwise.",
                "example": true,
                "readOnly": true,
                "type": "boolean"
              },
              "currency_code": {
                "description": "ISO 4217 currency code to format this custom field. This will be null if the `unit` is not `currency`.",
                "example": "EUR",
                "nullable": true,
                "type": "string"
              },
              "current_display_value": {
                "description": "This string is the current value of a goal metric of type string.",
                "example": "8.12",
                "readOnly": true,
                "type": "string"
              },
              "current_number_value": {
                "description": "This number is the current value of a goal metric of type number.",
                "example": 8.12,
                "type": "number"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "initial_number_value": {
                "description": "This number is the start value of a goal metric of type number.",
                "example": 5.2,
                "type": "number"
              },
              "is_custom_weight": {
                "description": "*Conditional*. Only relevant if `metric.progress_source` is one of `subgoal_progress`, `project_task_completion`, `project_milestone_completion`, or `task_completion`. If true, we use the supporting object's custom weight to calculate the goal's progress. If false, we treat all supporting objects as equally weighted",
                "example": false,
                "type": "boolean"
              },
              "precision": {
                "description": "*Conditional*. Only relevant for goal metrics of type `Number`. This field dictates the number of places after the decimal to round to, i.e. 0 is integer values, 1 rounds to the nearest tenth, and so on. Must be between 0 and 6, inclusive.\nFor percentage format, this may be unintuitive, as a value of 0.25 has a precision of 0, while a value of 0.251 has a precision of 1. This is due to 0.25 being displayed as 25%.",
                "example": 2,
                "type": "integer"
              },
              "progress_source": {
                "description": "This field defines how the progress value of a goal metric is being calculated. A goal's progress can be provided manually by the user, calculated automatically from contributing subgoals, projects, or tasks, or managed by an integration with an external data source, such as Salesforce.",
                "enum": [
                  "manual",
                  "subgoal_progress",
                  "project_task_completion",
                  "project_milestone_completion",
                  "task_completion",
                  "external"
                ],
                "example": "manual",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "number"
                ],
                "example": "number",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              },
              "target_number_value": {
                "description": "This number is the end value of a goal metric of type number. This number cannot equal `initial_number_value`.",
                "example": 10.2,
                "type": "number"
              },
              "unit": {
                "description": "A supported unit of measure for the goal metric, or none.",
                "enum": [
                  "none",
                  "currency",
                  "percentage"
                ],
                "type": "string"
              }
            },
            "type": "object"
          },
          "name": {
            "description": "The name of the goal.",
            "example": "Grow web traffic by 30%",
            "type": "string"
          },
          "notes": {
            "description": "Free-form textual information associated with the goal (i.e. its description).",
            "example": "Start building brand awareness.",
            "type": "string"
          },
          "num_likes": {
            "description": "The number of users who have liked this goal.",
            "example": 5,
            "readOnly": true,
            "type": "integer"
          },
          "owner": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "privacy_setting": {
            "description": "The privacy setting of the goal.",
            "enum": [
              "public_to_workspace",
              "members_only"
            ],
            "example": "public_to_workspace",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_on": {
            "description": "The day on which work for this goal begins, or null if the goal has no start date. This takes a date with `YYYY-MM-DD` format, and cannot be set unless there is an accompanying due date.",
            "example": "2019-09-14",
            "nullable": true,
            "type": "string"
          },
          "status": {
            "description": "The current status of this goal. When the goal is open, its status can be `green`, `yellow`, and `red` to reflect \"On Track\", \"At Risk\", and \"Off Track\", respectively. When the goal is closed, the value can be `missed`, `achieved`, `partial`, or `dropped`.\n*Note* you can only write to this property if `metric` is set.",
            "example": "green",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "team": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *team* is used to group related projects and people together within an organization. Each project in an organization is associated with a team.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *team* is used to group related projects and people together within an organization. Each project in an organization is associated with a team.\n*Conditional*. This property is only present when the `workspace` provided is an organization.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the team.",
                "example": "Marketing",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "team"
            }
          },
          "time_period": {
            "description": "A generic Asana Resource, containing a globally unique identifier.",
            "nullable": true,
            "properties": {
              "display_name": {
                "description": "A string representing the cadence code and the fiscal year.",
                "example": "Q1 FY22",
                "type": "string"
              },
              "end_on": {
                "description": "The localized end date of the time period in `YYYY-MM-DD` format.",
                "example": "2019-09-14",
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "period": {
                "description": "The cadence and index of the time period.",
                "enum": [
                  "FY",
                  "H1",
                  "H2",
                  "Q1",
                  "Q2",
                  "Q3",
                  "Q4"
                ],
                "example": "Q1",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              },
              "start_on": {
                "description": "The localized start date of the time period in `YYYY-MM-DD` format.",
                "example": "2019-09-13",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "time_period"
            }
          },
          "workspace": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the workspace.",
                "example": "My Company Workspace",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "workspace"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "goal"
        }
      },
      "sdk__GoalResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__GoalResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__GoalResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__GoalResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__GoalUpdateRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "custom_fields": {
            "additionalProperties": {
              "description": "\"{custom_field_gid}\" => Value (can be text, enum GID, a number, etc.). For date, use format \"YYYY-MM-DD\" (e.g., 2019-09-15). For date-time, use ISO 8601 date string in UTC (e.g., 2019-09-15T02:06:58.147Z).",
              "type": "string"
            },
            "description": "An object where each key is the GID of a custom field and its corresponding value is either an enum GID, string, number, or object (depending on the custom field type). See the [custom fields guide](/docs/custom-fields-guide) for details on creating and updating custom field values.",
            "example": {
              "4578152156": "Not Started",
              "5678904321": "On Hold"
            },
            "type": "object"
          },
          "due_on": {
            "description": "The localized day on which this goal is due. This takes a date with format `YYYY-MM-DD`.",
            "example": "2019-09-15",
            "nullable": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_custom_fields": {
            "additionalProperties": {
              "description": "\"{custom_field_gid}\" => HTML string (e.g., \"<body>Text content</body>\")",
              "type": "string"
            },
            "description": "An object where each key is the GID of a text custom field and the corresponding value is a rich text HTML string. Only text-type custom fields support this parameter. Values must be wrapped in <body></body> tags. See the [custom fields guide](/docs/custom-fields-guide) and [rich text](/docs/rich-text) for details on supported formatting.",
            "example": {
              "4578152156": "<body><code>Code block</code></body>",
              "5678904321": "<body><strong>Bold text</strong></body>"
            },
            "type": "object"
          },
          "html_notes": {
            "description": "The notes of the goal with formatting as HTML. See [rich text](/docs/rich-text).",
            "example": "<body>Start building brand awareness.</body>",
            "type": "string"
          },
          "is_workspace_level": {
            "description": "*Conditional*. This property is only present when the `workspace` provided is an organization. Whether the goal belongs to the `workspace` (and is listed as part of the workspace’s goals) or not. If it isn’t a workspace-level goal, it is a team-level goal, and is associated with the goal’s team.",
            "example": true,
            "type": "boolean"
          },
          "liked": {
            "description": "True if the goal is liked by the authorized user, false if not.",
            "example": false,
            "type": "boolean"
          },
          "name": {
            "description": "The name of the goal.",
            "example": "Grow web traffic by 30%",
            "type": "string"
          },
          "notes": {
            "description": "Free-form textual information associated with the goal (i.e. its description).",
            "example": "Start building brand awareness.",
            "type": "string"
          },
          "owner": {
            "description": "The `gid` of a user.",
            "example": "12345",
            "nullable": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_on": {
            "description": "The day on which work for this goal begins, or null if the goal has no start date. This takes a date with `YYYY-MM-DD` format, and cannot be set unless there is an accompanying due date.",
            "example": "2019-09-14",
            "nullable": true,
            "type": "string"
          },
          "status": {
            "description": "The current status of this goal. When the goal is open, its status can be `green`, `yellow`, and `red` to reflect \"On Track\", \"At Risk\", and \"Off Track\", respectively. When the goal is closed, the value can be `missed`, `achieved`, `partial`, or `dropped`.\n*Note* you can only write to this property if `metric` is set.",
            "example": "green",
            "nullable": true,
            "type": "string"
          },
          "team": {
            "description": "*Conditional*. This property is only present when the `workspace` provided is an organization.",
            "example": "12345",
            "nullable": true,
            "type": "string"
          },
          "time_period": {
            "description": "The `gid` of a time period.",
            "example": "12345",
            "nullable": true,
            "type": "string"
          },
          "workspace": {
            "description": "The `gid` of a workspace.",
            "example": "12345",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "goal"
        }
      },
      "sdk__GraphExportCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *graph_export* object represents a request to export the data starting from a parent object",
        "properties": {
          "completed_at": {
            "description": "The time at which this resource was completed.",
            "example": "2012-02-22T03:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "download_url": {
            "description": "Download this URL to retrieve the full export\nin JSON format. It will be compressed in a gzip (.gz) container.\n\n*Note: May be null if the export is still in progress or\nfailed.  If present, this URL may only be valid for 1 hour from\nthe time of retrieval. You should avoid persisting this URL\nsomewhere and rather refresh on demand to ensure you do not keep\nstale URLs.*",
            "example": "https://asana-export-us-east-1.s3.us-east-1.amazonaws.com/2563645399633793/domain_export/7588024658887731/download/ domain_export_2563645399633793_7588024658887731_2023018-201726.json.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256& X-Amz-Content-Sha256=xxxxxxxx&X-Amz-Date=xxxxxxxx&X-Amz-Expires=300&X-Amz-Security-Token=xxxxxxxx& X-Amz-Signature=xxxxxxxx&X-Amz-SignedHeaders=host&x-id=GetObject#_=_",
            "format": "uri",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "graph_export"
        }
      },
      "sdk__GraphExportRequest": {
        "description": "A *graph_export* request starts a job to export data starting from a parent object.",
        "properties": {
          "parent": {
            "description": "Globally unique ID of the parent object: goal, project, portfolio, or team.",
            "example": "181636",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__GraphExportResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "new_graph_export": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *graph_export* object represents a request to export the data starting from a parent object",
            "properties": {
              "completed_at": {
                "description": "The time at which this resource was completed.",
                "example": "2012-02-22T03:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "created_at": {
                "description": "The time at which this resource was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "download_url": {
                "description": "Download this URL to retrieve the full export\nin JSON format. It will be compressed in a gzip (.gz) container.\n\n*Note: May be null if the export is still in progress or\nfailed.  If present, this URL may only be valid for 1 hour from\nthe time of retrieval. You should avoid persisting this URL\nsomewhere and rather refresh on demand to ensure you do not keep\nstale URLs.*",
                "example": "https://asana-export-us-east-1.s3.us-east-1.amazonaws.com/2563645399633793/domain_export/7588024658887731/download/ domain_export_2563645399633793_7588024658887731_2023018-201726.json.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256& X-Amz-Content-Sha256=xxxxxxxx&X-Amz-Date=xxxxxxxx&X-Amz-Expires=300&X-Amz-Security-Token=xxxxxxxx& X-Amz-Signature=xxxxxxxx&X-Amz-SignedHeaders=host&x-id=GetObject#_=_",
                "format": "uri",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "graph_export"
            }
          },
          "resource_subtype": {
            "description": "A *graph_export* object represents a request to export the data starting from a parent object",
            "example": "graph_export_request",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "status": {
            "description": "The current status of this job.",
            "enum": [
              "not_started",
              "in_progress",
              "succeeded",
              "failed"
            ],
            "example": "succeeded",
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "job"
        }
      },
      "sdk__GraphExportResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__GraphExportResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__JobBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *job* is an object representing a process that handles asynchronous work.",
        "properties": {
          "dates_rollup_progress": {
            "description": "Progress of a subtask date rollup job. Only present on project rollup jobs; the object is empty until the job discovers tasks to reconcile.",
            "properties": {
              "total_tasks": {
                "description": "The total number of tasks discovered for reconciliation so far. This value may increase while the job is running and is final when the job completes.",
                "example": 40,
                "minimum": 0,
                "readOnly": true,
                "type": "integer"
              },
              "updated_tasks": {
                "description": "The number of tasks whose dates have been reconciled so far.",
                "example": 12,
                "minimum": 0,
                "readOnly": true,
                "type": "integer"
              }
            },
            "readOnly": true,
            "type": "object"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "new_graph_export": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *graph_export* object represents a request to export the data starting from a parent object",
            "properties": {
              "completed_at": {
                "description": "The time at which this resource was completed.",
                "example": "2012-02-22T03:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "created_at": {
                "description": "The time at which this resource was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "download_url": {
                "description": "Download this URL to retrieve the full export\nin JSON format. It will be compressed in a gzip (.gz) container.\n\n*Note: May be null if the export is still in progress or\nfailed.  If present, this URL may only be valid for 1 hour from\nthe time of retrieval. You should avoid persisting this URL\nsomewhere and rather refresh on demand to ensure you do not keep\nstale URLs.*",
                "example": "https://asana-export-us-east-1.s3.us-east-1.amazonaws.com/2563645399633793/domain_export/7588024658887731/download/ domain_export_2563645399633793_7588024658887731_2023018-201726.json.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256& X-Amz-Content-Sha256=xxxxxxxx&X-Amz-Date=xxxxxxxx&X-Amz-Expires=300&X-Amz-Security-Token=xxxxxxxx& X-Amz-Signature=xxxxxxxx&X-Amz-SignedHeaders=host&x-id=GetObject#_=_",
                "format": "uri",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "graph_export"
            }
          },
          "new_portfolio": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *portfolio* gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent [project status](/reference/project-statuses) update.\nPortfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the portfolio.",
                "example": "Bug Portfolio",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_portfolio",
                  "custom"
                ],
                "example": "default_portfolio",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "portfolio"
            }
          },
          "new_project": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          "new_project_template": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project template* is an object that allows new projects to be created with a predefined setup, which may include tasks, sections, Rules, etc. It simplifies the process of running a workflow that involves a similar set of work every time.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "Name of the project template.",
                "example": "Packing list",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project_template"
            }
          },
          "new_resource_export": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *resource_export* object represents a request to bulk export objects for one or more resources.",
            "properties": {
              "completed_at": {
                "description": "The time at which this resource was completed. This will be null if the export is still in progress.",
                "example": "2012-02-22T03:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "created_at": {
                "description": "The time at which the resource export object was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "download_url": {
                "description": "Download this URL to retrieve the full export\nin [JSON Lines](https://jsonlines.org/) format. It will be compressed in a gzip (.gz) container.\n\n*Note: May be null if the export is still in progress or failed.*",
                "example": "https://asana-export-us-east-1.s3.us-east-1.amazonaws.com/2563645399633793/object_export/7588024658887731/download/ object_export_2563645399633793_7588024658887731_2023018-201726.jsonl.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256& X-Amz-Credential=xxxxxxxx&X-Amz-Date=xxxxxxxx&X-Amz-Expires=300&X-Amz-Security-Token=xxxxxxxx& X-Amz-Signature=xxxxxxxx&X-Amz-SignedHeaders=host",
                "format": "uri",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "export_request"
            }
          },
          "new_task": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe *task* is the basic object around which many operations in Asana are centered.",
            "nullable": true,
            "properties": {
              "created_by": {
                "description": "[Opt In](/docs/inputoutput-options). A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource.",
                    "example": "1111",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of resource.",
                    "example": "user",
                    "type": "string"
                  }
                },
                "readOnly": true,
                "type": "object"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the task.",
                "example": "Bug Task",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe resource_subtype `milestone` represent a single moment in time. This means tasks with this subtype cannot have a start_date.",
                "enum": [
                  "default_task",
                  "milestone",
                  "approval",
                  "custom"
                ],
                "example": "default_task",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "task"
            }
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "example": "duplicate_task",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "status": {
            "description": "The current status of this job.",
            "enum": [
              "not_started",
              "in_progress",
              "succeeded",
              "failed"
            ],
            "example": "in_progress",
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "job"
        }
      },
      "sdk__JobCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *job* is an object representing a process that handles asynchronous work.",
        "properties": {
          "dates_rollup_progress": {
            "description": "Progress of a subtask date rollup job. Only present on project rollup jobs; the object is empty until the job discovers tasks to reconcile.",
            "properties": {
              "total_tasks": {
                "description": "The total number of tasks discovered for reconciliation so far. This value may increase while the job is running and is final when the job completes.",
                "example": 40,
                "minimum": 0,
                "readOnly": true,
                "type": "integer"
              },
              "updated_tasks": {
                "description": "The number of tasks whose dates have been reconciled so far.",
                "example": 12,
                "minimum": 0,
                "readOnly": true,
                "type": "integer"
              }
            },
            "readOnly": true,
            "type": "object"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "new_graph_export": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *graph_export* object represents a request to export the data starting from a parent object",
            "properties": {
              "completed_at": {
                "description": "The time at which this resource was completed.",
                "example": "2012-02-22T03:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "created_at": {
                "description": "The time at which this resource was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "download_url": {
                "description": "Download this URL to retrieve the full export\nin JSON format. It will be compressed in a gzip (.gz) container.\n\n*Note: May be null if the export is still in progress or\nfailed.  If present, this URL may only be valid for 1 hour from\nthe time of retrieval. You should avoid persisting this URL\nsomewhere and rather refresh on demand to ensure you do not keep\nstale URLs.*",
                "example": "https://asana-export-us-east-1.s3.us-east-1.amazonaws.com/2563645399633793/domain_export/7588024658887731/download/ domain_export_2563645399633793_7588024658887731_2023018-201726.json.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256& X-Amz-Content-Sha256=xxxxxxxx&X-Amz-Date=xxxxxxxx&X-Amz-Expires=300&X-Amz-Security-Token=xxxxxxxx& X-Amz-Signature=xxxxxxxx&X-Amz-SignedHeaders=host&x-id=GetObject#_=_",
                "format": "uri",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "graph_export"
            }
          },
          "new_portfolio": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *portfolio* gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent [project status](/reference/project-statuses) update.\nPortfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the portfolio.",
                "example": "Bug Portfolio",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_portfolio",
                  "custom"
                ],
                "example": "default_portfolio",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "portfolio"
            }
          },
          "new_project": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          "new_project_template": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project template* is an object that allows new projects to be created with a predefined setup, which may include tasks, sections, Rules, etc. It simplifies the process of running a workflow that involves a similar set of work every time.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "Name of the project template.",
                "example": "Packing list",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project_template"
            }
          },
          "new_resource_export": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *resource_export* object represents a request to bulk export objects for one or more resources.",
            "properties": {
              "completed_at": {
                "description": "The time at which this resource was completed. This will be null if the export is still in progress.",
                "example": "2012-02-22T03:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "created_at": {
                "description": "The time at which the resource export object was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "download_url": {
                "description": "Download this URL to retrieve the full export\nin [JSON Lines](https://jsonlines.org/) format. It will be compressed in a gzip (.gz) container.\n\n*Note: May be null if the export is still in progress or failed.*",
                "example": "https://asana-export-us-east-1.s3.us-east-1.amazonaws.com/2563645399633793/object_export/7588024658887731/download/ object_export_2563645399633793_7588024658887731_2023018-201726.jsonl.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256& X-Amz-Credential=xxxxxxxx&X-Amz-Date=xxxxxxxx&X-Amz-Expires=300&X-Amz-Security-Token=xxxxxxxx& X-Amz-Signature=xxxxxxxx&X-Amz-SignedHeaders=host",
                "format": "uri",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "export_request"
            }
          },
          "new_task": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe *task* is the basic object around which many operations in Asana are centered.",
            "nullable": true,
            "properties": {
              "created_by": {
                "description": "[Opt In](/docs/inputoutput-options). A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource.",
                    "example": "1111",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of resource.",
                    "example": "user",
                    "type": "string"
                  }
                },
                "readOnly": true,
                "type": "object"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the task.",
                "example": "Bug Task",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe resource_subtype `milestone` represent a single moment in time. This means tasks with this subtype cannot have a start_date.",
                "enum": [
                  "default_task",
                  "milestone",
                  "approval",
                  "custom"
                ],
                "example": "default_task",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "task"
            }
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "example": "duplicate_task",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "status": {
            "description": "The current status of this job.",
            "enum": [
              "not_started",
              "in_progress",
              "succeeded",
              "failed"
            ],
            "example": "in_progress",
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "job"
        }
      },
      "sdk__JobResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *job* is an object representing a process that handles asynchronous work.",
        "properties": {
          "dates_rollup_progress": {
            "description": "Progress of a subtask date rollup job. Only present on project rollup jobs; the object is empty until the job discovers tasks to reconcile.",
            "properties": {
              "total_tasks": {
                "description": "The total number of tasks discovered for reconciliation so far. This value may increase while the job is running and is final when the job completes.",
                "example": 40,
                "minimum": 0,
                "readOnly": true,
                "type": "integer"
              },
              "updated_tasks": {
                "description": "The number of tasks whose dates have been reconciled so far.",
                "example": 12,
                "minimum": 0,
                "readOnly": true,
                "type": "integer"
              }
            },
            "readOnly": true,
            "type": "object"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "new_graph_export": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *graph_export* object represents a request to export the data starting from a parent object",
            "properties": {
              "completed_at": {
                "description": "The time at which this resource was completed.",
                "example": "2012-02-22T03:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "created_at": {
                "description": "The time at which this resource was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "download_url": {
                "description": "Download this URL to retrieve the full export\nin JSON format. It will be compressed in a gzip (.gz) container.\n\n*Note: May be null if the export is still in progress or\nfailed.  If present, this URL may only be valid for 1 hour from\nthe time of retrieval. You should avoid persisting this URL\nsomewhere and rather refresh on demand to ensure you do not keep\nstale URLs.*",
                "example": "https://asana-export-us-east-1.s3.us-east-1.amazonaws.com/2563645399633793/domain_export/7588024658887731/download/ domain_export_2563645399633793_7588024658887731_2023018-201726.json.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256& X-Amz-Content-Sha256=xxxxxxxx&X-Amz-Date=xxxxxxxx&X-Amz-Expires=300&X-Amz-Security-Token=xxxxxxxx& X-Amz-Signature=xxxxxxxx&X-Amz-SignedHeaders=host&x-id=GetObject#_=_",
                "format": "uri",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "graph_export"
            }
          },
          "new_portfolio": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *portfolio* gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent [project status](/reference/project-statuses) update.\nPortfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the portfolio.",
                "example": "Bug Portfolio",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_portfolio",
                  "custom"
                ],
                "example": "default_portfolio",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "portfolio"
            }
          },
          "new_project": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          "new_project_template": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project template* is an object that allows new projects to be created with a predefined setup, which may include tasks, sections, Rules, etc. It simplifies the process of running a workflow that involves a similar set of work every time.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "Name of the project template.",
                "example": "Packing list",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project_template"
            }
          },
          "new_resource_export": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *resource_export* object represents a request to bulk export objects for one or more resources.",
            "properties": {
              "completed_at": {
                "description": "The time at which this resource was completed. This will be null if the export is still in progress.",
                "example": "2012-02-22T03:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "created_at": {
                "description": "The time at which the resource export object was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "download_url": {
                "description": "Download this URL to retrieve the full export\nin [JSON Lines](https://jsonlines.org/) format. It will be compressed in a gzip (.gz) container.\n\n*Note: May be null if the export is still in progress or failed.*",
                "example": "https://asana-export-us-east-1.s3.us-east-1.amazonaws.com/2563645399633793/object_export/7588024658887731/download/ object_export_2563645399633793_7588024658887731_2023018-201726.jsonl.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256& X-Amz-Credential=xxxxxxxx&X-Amz-Date=xxxxxxxx&X-Amz-Expires=300&X-Amz-Security-Token=xxxxxxxx& X-Amz-Signature=xxxxxxxx&X-Amz-SignedHeaders=host",
                "format": "uri",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "export_request"
            }
          },
          "new_task": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe *task* is the basic object around which many operations in Asana are centered.",
            "nullable": true,
            "properties": {
              "created_by": {
                "description": "[Opt In](/docs/inputoutput-options). A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource.",
                    "example": "1111",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of resource.",
                    "example": "user",
                    "type": "string"
                  }
                },
                "readOnly": true,
                "type": "object"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the task.",
                "example": "Bug Task",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe resource_subtype `milestone` represent a single moment in time. This means tasks with this subtype cannot have a start_date.",
                "enum": [
                  "default_task",
                  "milestone",
                  "approval",
                  "custom"
                ],
                "example": "default_task",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "task"
            }
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "example": "duplicate_task",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "status": {
            "description": "The current status of this job.",
            "enum": [
              "not_started",
              "in_progress",
              "succeeded",
              "failed"
            ],
            "example": "in_progress",
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "job"
        }
      },
      "sdk__JobResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__JobResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__Like": {
        "description": "An object to represent a user's like.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the object, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string"
          },
          "user": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          }
        },
        "type": "object"
      },
      "sdk__MarkNotificationsRequest": {
        "properties": {
          "notification_gids": {
            "description": "The notifications to update. Between 1 and 50 GIDs may be supplied, and duplicate GIDs are ignored.",
            "example": [
              "1234567890",
              "1234567891"
            ],
            "items": {
              "description": "The `gid` of a notification.",
              "type": "string"
            },
            "maxItems": 50,
            "minItems": 1,
            "type": "array"
          },
          "workspace": {
            "description": "GID of the workspace used to route the request.",
            "example": "31326",
            "type": "string"
          }
        },
        "required": [
          "workspace",
          "notification_gids"
        ],
        "type": "object"
      },
      "sdk__MarkNotificationsResponse": {
        "properties": {
          "failed_gids": {
            "description": "The GIDs from notification_gids that could not be updated, for example because the notification does not exist, does not belong to the caller, or has been deleted. GIDs not listed here were updated successfully. Empty when every GID succeeded.",
            "example": [
              "1234567891"
            ],
            "items": {
              "description": "The `gid` of a notification that failed to update.",
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "sdk__MarkNotificationsResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__MarkNotificationsResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__MemberCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the member",
            "example": "Greg Sanchez",
            "type": "string"
          },
          "resource_type": {
            "description": "The type of the member (team or user)",
            "example": "user",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "member"
        }
      },
      "sdk__MembershipCompact": {
        "anyOf": [
          {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object represents a user's connection to a goal.",
            "properties": {
              "access_level": {
                "description": "\"Describes the membership access level for the goal. This is preferred over role.\"",
                "enum": [
                  "viewer",
                  "commenter",
                  "editor",
                  "admin"
                ],
                "example": "editor",
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "goal": {
                "deprecated": true,
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\n*Deprecated: new integrations should prefer the `parent` field.* A *Goal* is an object in the goal-tracking system that helps your organization drive measurable results.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the goal.",
                    "example": "Grow web traffic by 30%",
                    "type": "string"
                  },
                  "owner": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                    "nullable": true,
                    "properties": {
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "*Read-only except when same user as requester*. The user's name.",
                        "example": "Greg Sanchez",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "user"
                    }
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "readOnly": true,
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "goal"
                }
              },
              "is_commenter": {
                "deprecated": true,
                "description": "*Deprecated: new integrations should prefer the `access_level` field.* Describes if the member is comment only in goal. This field is deprecated and will always be null.",
                "example": false,
                "readOnly": true,
                "type": "boolean"
              },
              "is_editor": {
                "deprecated": true,
                "description": "*Deprecated: new integrations should prefer the `access_level` field.* Describes if the member is editor in goal. This field is deprecated and will always be null.",
                "example": false,
                "readOnly": true,
                "type": "boolean"
              },
              "member": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the member",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of the member (team or user)",
                    "example": "user",
                    "type": "string"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "member"
                }
              },
              "parent": {
                "description": "A generic Asana Resource, containing a globally unique identifier.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the goal.",
                    "example": "Grow web traffic by 30%",
                    "type": "string"
                  },
                  "owner": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                    "nullable": true,
                    "properties": {
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "*Read-only except when same user as requester*. The user's name.",
                        "example": "Greg Sanchez",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "user"
                    }
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "readOnly": true,
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "goal"
                }
              },
              "resource_subtype": {
                "description": "The type of membership.",
                "example": "goal_membership",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "membership",
                "type": "string"
              },
              "role": {
                "deprecated": true,
                "description": "*Deprecated: Describes if the member is a commenter or editor in goal.*",
                "enum": [
                  "commenter",
                  "editor"
                ],
                "example": "editor",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "membership"
            }
          },
          {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object describes a team or a user's membership to a project including their level of access (Admin, Editor, Commenter, or Viewer).",
            "properties": {
              "access_level": {
                "description": "Whether the member has admin, editor, commenter, or viewer access to the project.",
                "enum": [
                  "admin",
                  "editor",
                  "commenter",
                  "viewer"
                ],
                "example": "admin",
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "member": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the member",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of the member (team or user)",
                    "example": "user",
                    "type": "string"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "member"
                }
              },
              "parent": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "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.",
                    "example": "Stuff to buy",
                    "type": "string"
                  },
                  "resource_subtype": {
                    "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                    "enum": [
                      "default_project",
                      "custom"
                    ],
                    "example": "default_project",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "project"
                }
              },
              "resource_subtype": {
                "description": "Type of the membership.",
                "example": "project_membership",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "membership",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project_membership"
            }
          },
          {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object determines if a user is a member of a portfolio.",
            "properties": {
              "access_level": {
                "description": "Whether the member has admin, editor, or viewer access to the portfolio. Portfolios do not support commenter access yet.",
                "enum": [
                  "admin",
                  "editor",
                  "viewer"
                ],
                "example": "admin",
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "member": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the member",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of the member (team or user)",
                    "example": "user",
                    "type": "string"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "member"
                }
              },
              "parent": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *portfolio* gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent [project status](/reference/project-statuses) update.\nPortfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the portfolio.",
                    "example": "Bug Portfolio",
                    "type": "string"
                  },
                  "resource_subtype": {
                    "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                    "enum": [
                      "default_portfolio",
                      "custom"
                    ],
                    "example": "default_portfolio",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "portfolio"
                }
              },
              "resource_subtype": {
                "description": "Type of the membership.",
                "example": "portfolio_membership",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "membership",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "portfolio_membership"
            }
          },
          {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object describes a user or team's membership to a custom field including their level of access (Admin, Editor, or User).",
            "properties": {
              "access_level": {
                "description": "Whether the member has admin, editor, or user access to the custom field.",
                "enum": [
                  "admin",
                  "editor",
                  "user"
                ],
                "example": "admin",
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "member": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the member",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of the member (team or user)",
                    "example": "user",
                    "type": "string"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "member"
                }
              },
              "parent": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.",
                "properties": {
                  "date_value": {
                    "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                    "nullable": true,
                    "properties": {
                      "date": {
                        "description": "A string representing the date in YYYY-MM-DD format.",
                        "example": "2024-08-23",
                        "type": "string"
                      },
                      "date_time": {
                        "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                        "example": "2024-08-23T22:00:00.000Z",
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "display_value": {
                    "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                    "example": "blue",
                    "nullable": true,
                    "readOnly": true,
                    "type": "string"
                  },
                  "enabled": {
                    "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                    "example": true,
                    "readOnly": true,
                    "type": "boolean"
                  },
                  "enum_options": {
                    "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                    "items": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                      "properties": {
                        "color": {
                          "description": "The color of the enum option. Defaults to `none`.",
                          "example": "blue",
                          "type": "string"
                        },
                        "enabled": {
                          "description": "Whether or not the enum option is a selectable value for the custom field.",
                          "example": true,
                          "type": "boolean"
                        },
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "The name of the enum option.",
                          "example": "Low",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "enum_option"
                      }
                    },
                    "type": "array"
                  },
                  "enum_value": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                    "nullable": true,
                    "properties": {
                      "color": {
                        "description": "The color of the enum option. Defaults to `none`.",
                        "example": "blue",
                        "type": "string"
                      },
                      "enabled": {
                        "description": "Whether or not the enum option is a selectable value for the custom field.",
                        "example": true,
                        "type": "boolean"
                      },
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "The name of the enum option.",
                        "example": "Low",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "enum_option"
                    }
                  },
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "id_prefix": {
                    "description": "This field is the unique custom ID string for the custom field.",
                    "example": "ID",
                    "nullable": true,
                    "type": "string"
                  },
                  "input_restrictions": {
                    "example": [
                      "task"
                    ],
                    "items": {
                      "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                      "enum": [
                        "task",
                        "project",
                        "portfolio",
                        "goal"
                      ],
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "is_formula_field": {
                    "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                    "example": false,
                    "type": "boolean"
                  },
                  "is_lookup_field": {
                    "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                    "example": false,
                    "type": "boolean"
                  },
                  "multi_enum_values": {
                    "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                    "items": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                      "properties": {
                        "color": {
                          "description": "The color of the enum option. Defaults to `none`.",
                          "example": "blue",
                          "type": "string"
                        },
                        "enabled": {
                          "description": "Whether or not the enum option is a selectable value for the custom field.",
                          "example": true,
                          "type": "boolean"
                        },
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "The name of the enum option.",
                          "example": "Low",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "enum_option"
                      }
                    },
                    "type": "array"
                  },
                  "name": {
                    "description": "The name of the custom field.",
                    "example": "Status",
                    "type": "string"
                  },
                  "number_value": {
                    "description": "*Conditional*. This number is the value of a `number` custom field.",
                    "example": 5.2,
                    "nullable": true,
                    "type": "number"
                  },
                  "representation_type": {
                    "description": "This field tells the type of the custom field.",
                    "enum": [
                      "text",
                      "enum",
                      "multi_enum",
                      "number",
                      "date",
                      "people",
                      "formula",
                      "custom_id",
                      "reference"
                    ],
                    "example": "number",
                    "readOnly": true,
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  },
                  "text_value": {
                    "description": "*Conditional*. This string is the value of a `text` custom field.",
                    "example": "Some Value",
                    "nullable": true,
                    "type": "string"
                  },
                  "type": {
                    "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                    "enum": [
                      "text",
                      "enum",
                      "multi_enum",
                      "number",
                      "date",
                      "people",
                      "reference"
                    ],
                    "readOnly": true,
                    "type": "string"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "custom_field"
                }
              },
              "resource_subtype": {
                "description": "Type of the membership.",
                "example": "custom_field_membership",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "custom_field_membership"
            }
          },
          {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object describes a user or team's membership to a custom type including their level of access (Admin, Editor, User, or Viewer).",
            "properties": {
              "access_level": {
                "description": "Whether the member has admin, editor, user, or viewer access to the custom type.",
                "enum": [
                  "admin",
                  "editor",
                  "user",
                  "viewer"
                ],
                "example": "admin",
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "member": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the member",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of the member (team or user)",
                    "example": "user",
                    "type": "string"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "member"
                }
              },
              "parent": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Types extend the types of Asana Objects.",
                "properties": {
                  "asana_created_type_identifier": {
                    "description": "*Read-only*. A stable identifier present when this custom type was created by Asana as part of an Asana product (for example, a Command ticket type or a Service queue type). `null` for custom types created by users, and for Asana-created types that do not have a public identifier yet. New values may be added over time as Asana products introduce new types; integrations should tolerate unrecognized values.",
                    "enum": [
                      "COMMAND_TICKET",
                      "COMMAND_RELEASE",
                      "COMMAND_TEAMSPACE",
                      "SERVICE_TICKET",
                      "SERVICE_CONVERSATION",
                      "SERVICE_QUEUE"
                    ],
                    "example": "COMMAND_TICKET",
                    "nullable": true,
                    "readOnly": true,
                    "type": "string"
                  },
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the custom type.",
                    "example": "Bug ticket",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "custom_type"
                }
              },
              "resource_subtype": {
                "description": "Type of the membership.",
                "example": "custom_type_membership",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "custom_type_membership"
            }
          },
          {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA user or team's membership in a table.",
            "properties": {
              "access_level": {
                "description": "The member's access level in the table.",
                "enum": [
                  "admin",
                  "editor",
                  "commenter",
                  "viewer"
                ],
                "example": "viewer",
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "member": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the member",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of the member (team or user)",
                    "example": "user",
                    "type": "string"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "member"
                }
              },
              "parent": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *table* is a container for structured records (rows), with columns defined by custom field settings.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the table.",
                    "example": "Vendor contracts",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "table"
                }
              },
              "resource_subtype": {
                "description": "Type of the membership.",
                "example": "table_membership",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "membership"
            }
          },
          {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA user or team's membership in a record.",
            "properties": {
              "access_level": {
                "description": "The member's access level in the record.",
                "enum": [
                  "admin",
                  "editor",
                  "commenter",
                  "viewer"
                ],
                "example": "viewer",
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "member": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the member",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of the member (team or user)",
                    "example": "user",
                    "type": "string"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "member"
                }
              },
              "parent": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *record* is a single row in a table. Fields on a record are backed by the table's custom field settings.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the record.",
                    "example": "Q3 renewal",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "record"
                }
              },
              "resource_subtype": {
                "description": "Type of the membership.",
                "example": "record_membership",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "membership"
            }
          }
        ]
      },
      "sdk__MembershipRequest": {
        "properties": {
          "access_level": {
            "description": "Sets the access level for the member. Goals can have access levels `viewer`, `commenter`, `editor` or `admin`. Projects can have access levels `admin`, `editor` or `commenter`. Portfolios can have access levels `admin`, `editor` or `viewer`. Custom Fields can have access levels `admin`, `editor` or `user`. Tables accept `admin`, `editor`, or `viewer` on creation. Records accept `admin`, `editor`, `commenter`, or `viewer`.",
            "example": "editor",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__MembershipResponse": {
        "anyOf": [
          {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object represents a user's connection to a goal.",
            "properties": {
              "access_level": {
                "description": "\"Describes the membership access level for the goal. This is preferred over role.\"",
                "enum": [
                  "viewer",
                  "commenter",
                  "editor",
                  "admin"
                ],
                "example": "editor",
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "goal": {
                "deprecated": true,
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\n*Deprecated: new integrations should prefer the `parent` field.* A *Goal* is an object in the goal-tracking system that helps your organization drive measurable results.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the goal.",
                    "example": "Grow web traffic by 30%",
                    "type": "string"
                  },
                  "owner": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                    "nullable": true,
                    "properties": {
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "*Read-only except when same user as requester*. The user's name.",
                        "example": "Greg Sanchez",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "user"
                    }
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "readOnly": true,
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "goal"
                }
              },
              "member": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the member",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of the member (team or user)",
                    "example": "user",
                    "type": "string"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "member"
                }
              },
              "parent": {
                "description": "A generic Asana Resource, containing a globally unique identifier.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the goal.",
                    "example": "Grow web traffic by 30%",
                    "type": "string"
                  },
                  "owner": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                    "nullable": true,
                    "properties": {
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "*Read-only except when same user as requester*. The user's name.",
                        "example": "Greg Sanchez",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "user"
                    }
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "readOnly": true,
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "goal"
                }
              },
              "resource_subtype": {
                "description": "The type of membership.",
                "example": "goal_membership",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "membership",
                "type": "string"
              },
              "role": {
                "deprecated": true,
                "description": "*Deprecated: Describes if the member is a commenter or editor in goal.*",
                "enum": [
                  "commenter",
                  "editor"
                ],
                "example": "editor",
                "type": "string"
              },
              "user": {
                "deprecated": true,
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.\n*Deprecated: new integrations should prefer the `member` field.* A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "readOnly": true,
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "workspace": {
                "deprecated": true,
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.\n*Deprecated:* A *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the workspace.",
                    "example": "My Company Workspace",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "readOnly": true,
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "workspace"
                }
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "membership"
            }
          },
          {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object describes a team or a user's membership to a project including their level of access (Admin, Editor, Commenter, or Viewer).",
            "properties": {
              "access_level": {
                "description": "Whether the member has admin, editor, commenter, or viewer access to the project.",
                "enum": [
                  "admin",
                  "editor",
                  "commenter",
                  "viewer"
                ],
                "example": "admin",
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "member": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the member",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of the member (team or user)",
                    "example": "user",
                    "type": "string"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "member"
                }
              },
              "parent": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "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.",
                    "example": "Stuff to buy",
                    "type": "string"
                  },
                  "resource_subtype": {
                    "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                    "enum": [
                      "default_project",
                      "custom"
                    ],
                    "example": "default_project",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "project"
                }
              },
              "resource_subtype": {
                "description": "Type of the membership.",
                "example": "project_membership",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "membership",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project_membership"
            }
          },
          {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object determines if a user is a member of a portfolio.",
            "properties": {
              "access_level": {
                "description": "Whether the member has admin, editor, or viewer access to the portfolio. Portfolios do not support commenter access yet.",
                "enum": [
                  "admin",
                  "editor",
                  "viewer"
                ],
                "example": "admin",
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "member": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the member",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of the member (team or user)",
                    "example": "user",
                    "type": "string"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "member"
                }
              },
              "parent": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *portfolio* gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent [project status](/reference/project-statuses) update.\nPortfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the portfolio.",
                    "example": "Bug Portfolio",
                    "type": "string"
                  },
                  "resource_subtype": {
                    "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                    "enum": [
                      "default_portfolio",
                      "custom"
                    ],
                    "example": "default_portfolio",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "portfolio"
                }
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "portfolio_membership"
            }
          },
          {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object describes a user or team's membership to a custom field including their level of access (Admin, Editor, or User).",
            "properties": {
              "access_level": {
                "description": "Whether the member has admin, editor, or user access to the custom field.",
                "enum": [
                  "admin",
                  "editor",
                  "user"
                ],
                "example": "admin",
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "member": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the member",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of the member (team or user)",
                    "example": "user",
                    "type": "string"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "member"
                }
              },
              "parent": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.",
                "properties": {
                  "date_value": {
                    "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                    "nullable": true,
                    "properties": {
                      "date": {
                        "description": "A string representing the date in YYYY-MM-DD format.",
                        "example": "2024-08-23",
                        "type": "string"
                      },
                      "date_time": {
                        "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                        "example": "2024-08-23T22:00:00.000Z",
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "display_value": {
                    "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                    "example": "blue",
                    "nullable": true,
                    "readOnly": true,
                    "type": "string"
                  },
                  "enabled": {
                    "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                    "example": true,
                    "readOnly": true,
                    "type": "boolean"
                  },
                  "enum_options": {
                    "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                    "items": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                      "properties": {
                        "color": {
                          "description": "The color of the enum option. Defaults to `none`.",
                          "example": "blue",
                          "type": "string"
                        },
                        "enabled": {
                          "description": "Whether or not the enum option is a selectable value for the custom field.",
                          "example": true,
                          "type": "boolean"
                        },
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "The name of the enum option.",
                          "example": "Low",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "enum_option"
                      }
                    },
                    "type": "array"
                  },
                  "enum_value": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                    "nullable": true,
                    "properties": {
                      "color": {
                        "description": "The color of the enum option. Defaults to `none`.",
                        "example": "blue",
                        "type": "string"
                      },
                      "enabled": {
                        "description": "Whether or not the enum option is a selectable value for the custom field.",
                        "example": true,
                        "type": "boolean"
                      },
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "The name of the enum option.",
                        "example": "Low",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "enum_option"
                    }
                  },
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "id_prefix": {
                    "description": "This field is the unique custom ID string for the custom field.",
                    "example": "ID",
                    "nullable": true,
                    "type": "string"
                  },
                  "input_restrictions": {
                    "example": [
                      "task"
                    ],
                    "items": {
                      "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                      "enum": [
                        "task",
                        "project",
                        "portfolio",
                        "goal"
                      ],
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "is_formula_field": {
                    "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                    "example": false,
                    "type": "boolean"
                  },
                  "is_lookup_field": {
                    "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                    "example": false,
                    "type": "boolean"
                  },
                  "multi_enum_values": {
                    "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                    "items": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                      "properties": {
                        "color": {
                          "description": "The color of the enum option. Defaults to `none`.",
                          "example": "blue",
                          "type": "string"
                        },
                        "enabled": {
                          "description": "Whether or not the enum option is a selectable value for the custom field.",
                          "example": true,
                          "type": "boolean"
                        },
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "The name of the enum option.",
                          "example": "Low",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "enum_option"
                      }
                    },
                    "type": "array"
                  },
                  "name": {
                    "description": "The name of the custom field.",
                    "example": "Status",
                    "type": "string"
                  },
                  "number_value": {
                    "description": "*Conditional*. This number is the value of a `number` custom field.",
                    "example": 5.2,
                    "nullable": true,
                    "type": "number"
                  },
                  "representation_type": {
                    "description": "This field tells the type of the custom field.",
                    "enum": [
                      "text",
                      "enum",
                      "multi_enum",
                      "number",
                      "date",
                      "people",
                      "formula",
                      "custom_id",
                      "reference"
                    ],
                    "example": "number",
                    "readOnly": true,
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  },
                  "text_value": {
                    "description": "*Conditional*. This string is the value of a `text` custom field.",
                    "example": "Some Value",
                    "nullable": true,
                    "type": "string"
                  },
                  "type": {
                    "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                    "enum": [
                      "text",
                      "enum",
                      "multi_enum",
                      "number",
                      "date",
                      "people",
                      "reference"
                    ],
                    "readOnly": true,
                    "type": "string"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "custom_field"
                }
              },
              "resource_subtype": {
                "description": "Type of the membership.",
                "example": "custom_field_membership",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "custom_field_membership"
            }
          },
          {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object describes a user or team's membership to a custom type including their level of access (Admin, Editor, User, or Viewer).",
            "properties": {
              "access_level": {
                "description": "Whether the member has admin, editor, user, or viewer access to the custom type.",
                "enum": [
                  "admin",
                  "editor",
                  "user",
                  "viewer"
                ],
                "example": "admin",
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "member": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the member",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of the member (team or user)",
                    "example": "user",
                    "type": "string"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "member"
                }
              },
              "parent": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Types extend the types of Asana Objects.",
                "properties": {
                  "asana_created_type_identifier": {
                    "description": "*Read-only*. A stable identifier present when this custom type was created by Asana as part of an Asana product (for example, a Command ticket type or a Service queue type). `null` for custom types created by users, and for Asana-created types that do not have a public identifier yet. New values may be added over time as Asana products introduce new types; integrations should tolerate unrecognized values.",
                    "enum": [
                      "COMMAND_TICKET",
                      "COMMAND_RELEASE",
                      "COMMAND_TEAMSPACE",
                      "SERVICE_TICKET",
                      "SERVICE_CONVERSATION",
                      "SERVICE_QUEUE"
                    ],
                    "example": "COMMAND_TICKET",
                    "nullable": true,
                    "readOnly": true,
                    "type": "string"
                  },
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the custom type.",
                    "example": "Bug ticket",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "custom_type"
                }
              },
              "resource_subtype": {
                "description": "Type of the membership.",
                "example": "custom_type_membership",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "custom_type_membership"
            }
          },
          {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA user or team's membership in a table.",
            "properties": {
              "access_level": {
                "description": "The member's access level in the table.",
                "enum": [
                  "admin",
                  "editor",
                  "commenter",
                  "viewer"
                ],
                "example": "viewer",
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "member": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the member",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of the member (team or user)",
                    "example": "user",
                    "type": "string"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "member"
                }
              },
              "parent": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *table* is a container for structured records (rows), with columns defined by custom field settings.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the table.",
                    "example": "Vendor contracts",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "table"
                }
              },
              "resource_subtype": {
                "description": "Type of the membership.",
                "example": "table_membership",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "membership"
            }
          },
          {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA user or team's membership in a record.",
            "properties": {
              "access_level": {
                "description": "The member's access level in the record.",
                "enum": [
                  "admin",
                  "editor",
                  "commenter",
                  "viewer"
                ],
                "example": "viewer",
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "member": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the member",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of the member (team or user)",
                    "example": "user",
                    "type": "string"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "member"
                }
              },
              "parent": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *record* is a single row in a table. Fields on a record are backed by the table's custom field settings.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the record.",
                    "example": "Q3 renewal",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "record"
                }
              },
              "resource_subtype": {
                "description": "Type of the membership.",
                "example": "record_membership",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "membership"
            }
          }
        ]
      },
      "sdk__MembershipResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__MembershipResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__MembershipResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__MembershipResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__MembershipUpdateRequest": {
        "properties": {
          "access_level": {
            "description": "The role given to the member. Goals can have access levels `editor` or `commenter`. Projects can have access levels `admin`, `editor` or `commenter`. Portfolios can have access levels `admin`, `editor` or `viewer`.",
            "example": "editor",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__ModifyDependenciesRequest": {
        "example": {
          "dependencies": [
            "133713",
            "184253"
          ]
        },
        "properties": {
          "dependencies": {
            "description": "An array of task gids that a task depends on.",
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "sdk__ModifyDependentsRequest": {
        "description": "A set of dependent tasks.",
        "example": {
          "dependents": [
            "133713",
            "184253"
          ]
        },
        "properties": {
          "dependents": {
            "description": "An array of task gids that are dependents of the given task.",
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "sdk__NextPage": {
        "description": "*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.",
        "nullable": true,
        "properties": {
          "offset": {
            "description": "Pagination offset for the request.",
            "example": "eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9",
            "readOnly": true,
            "type": "string"
          },
          "path": {
            "description": "A relative path containing the query parameters to fetch for next_page",
            "example": "/tasks/12345/attachments?limit=2&offset=eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9",
            "readOnly": true,
            "type": "string"
          },
          "uri": {
            "description": "A full uri containing the query parameters to fetch for next_page",
            "example": "https://app.asana.com/api/1.0/tasks/12345/attachments?limit=2&offset=eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9",
            "format": "uri",
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__NotificationBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *notification* is a recipient-specific record generated for the authenticated user when a story they should be notified about occurs in Asana. Multiple notifications can refer to the same underlying story, one per eligible recipient.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "required": [
          "gid",
          "resource_type"
        ],
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "notification"
        }
      },
      "sdk__NotificationCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *notification* is a recipient-specific record generated for the authenticated user when a story they should be notified about occurs in Asana. Multiple notifications can refer to the same underlying story, one per eligible recipient.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "required": [
          "gid",
          "resource_type"
        ],
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "notification"
        }
      },
      "sdk__NotificationResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *notification* is a recipient-specific record generated for the authenticated user when a story they should be notified about occurs in Asana. Multiple notifications can refer to the same underlying story, one per eligible recipient.",
        "properties": {
          "created_at": {
            "description": "The time at which the notification was created.",
            "example": "2026-08-20T18:42:31.123Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "created_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe computed actor responsible for the underlying activity, or `null` when no actor is available.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the object.",
                "example": "Bug Task",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "is_read": {
            "description": "Whether the notification is effectively read in the user's Inbox.",
            "example": false,
            "readOnly": true,
            "type": "boolean"
          },
          "priority_classification": {
            "description": "The notification's Priority classification.",
            "enum": [
              "unclassified"
            ],
            "example": "unclassified",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "story": {
            "allOf": [
              {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA story represents an activity associated with an object in the Asana system.",
                "properties": {
                  "anchor_gid": {
                    "description": "*Conditional*. The GID of the object this comment is anchored to. For a top-level task comment this is the task GID; for a threaded reply this is the parent comment's envelope GID (`comment_gid`). Also present on sticker stories. Request with `opt_fields=anchor_gid` on story reads.",
                    "example": "12345",
                    "nullable": true,
                    "readOnly": true,
                    "type": "string"
                  },
                  "comment_gid": {
                    "description": "*Conditional*. The GID of this comment's envelope, distinct from the story `gid`. Request with `opt_fields=comment_gid` on story reads. For a top-level task comment, pass this value as `parent_comment` when creating a threaded reply. Null for a legacy comment without an envelope; absent on non-comment stories.",
                    "example": "12345",
                    "nullable": true,
                    "readOnly": true,
                    "type": "string"
                  },
                  "created_at": {
                    "description": "The time at which this resource was created.",
                    "example": "2012-02-22T02:06:58.147Z",
                    "format": "date-time",
                    "readOnly": true,
                    "type": "string"
                  },
                  "created_by": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                    "properties": {
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "*Read-only except when same user as requester*. The user's name.",
                        "example": "Greg Sanchez",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "user"
                    }
                  },
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "resource_subtype": {
                    "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                    "example": "comment_added",
                    "readOnly": true,
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  },
                  "text": {
                    "description": "*Create-only*. Human-readable text for the story or comment.\nThis will not include the name of the creator.\n*Note: This is not guaranteed to be stable for a given type of story. For example, text for a reassignment may not always say “assigned to …” as the text for a story can both be edited and change based on the language settings of the user making the request.*\nUse the `resource_subtype` property to discover the action that created the story.",
                    "example": "marked today",
                    "type": "string"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "story"
                }
              }
            ],
            "description": "The Story that produced the notification. This is `null` when the activity is not exposed through the Stories API.",
            "nullable": true,
            "readOnly": true,
            "type": "object"
          },
          "story_resource_subtype": {
            "description": "The stable public subtype of the Story that produced the notification.",
            "example": "comment_added",
            "readOnly": true,
            "type": "string"
          },
          "work_objects": {
            "description": "Work referenced by the notification. Each entry is a compact representation of the underlying Asana resource.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "The name of the object.",
                  "example": "Bug Task",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          }
        },
        "required": [
          "gid",
          "resource_type",
          "priority_classification",
          "story_resource_subtype",
          "work_objects",
          "story",
          "created_by",
          "created_at",
          "is_read"
        ],
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "notification"
        }
      },
      "sdk__NotificationResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__NotificationResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__OooEntryBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "end_date": {
            "description": "The day on which the OOO entry ends.",
            "example": "2024-01-15",
            "format": "date",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_date": {
            "description": "The day on which the OOO entry starts.",
            "example": "2024-01-01",
            "format": "date",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "ooo_entry"
        }
      },
      "sdk__OooEntryCreateRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "end_date": {
            "description": "The day on which the OOO entry ends.",
            "example": "2024-01-15",
            "format": "date",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_date": {
            "description": "The day on which the OOO entry starts.",
            "example": "2024-01-01",
            "format": "date",
            "type": "string"
          },
          "user": {
            "description": "Globally unique identifier for the user who is out of office.",
            "type": "string"
          },
          "workspace": {
            "description": "Globally unique identifier for the workspace.",
            "example": "98765",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "ooo_entry"
        }
      },
      "sdk__OooEntryResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "created_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "end_date": {
            "description": "The day on which the OOO entry ends.",
            "example": "2024-01-15",
            "format": "date",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_date": {
            "description": "The day on which the OOO entry starts.",
            "example": "2024-01-01",
            "format": "date",
            "type": "string"
          },
          "user": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "ooo_entry"
        }
      },
      "sdk__OooEntryResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__OooEntryResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__OooEntryResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__OooEntryResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__OooEntryUpdateRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "end_date": {
            "description": "The day on which the OOO entry ends.",
            "example": "2024-01-15",
            "format": "date",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_date": {
            "description": "The day on which the OOO entry starts.",
            "example": "2024-01-01",
            "format": "date",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "ooo_entry"
        }
      },
      "sdk__OrganizationExportBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nAn *organization_export* object represents a request to export the complete data of an Organization in JSON format.",
        "properties": {
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "download_url": {
            "description": "Download this URL to retrieve the full export of the organization\nin JSON format. It will be compressed in a gzip (.gz) container.\n\n*Note: May be null if the export is still in progress or\nfailed.  If present, this URL may only be valid for 1 hour from\nthe time of retrieval. You should avoid persisting this URL\nsomewhere and rather refresh on demand to ensure you do not keep\nstale URLs.*",
            "example": "https://asana-export-us-east-1.s3.us-east-1.amazonaws.com/2563645399633793/domain_export/7588024658887731/download/ domain_export_2563645399633793_7588024658887731_2023018-201726.json.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256& X-Amz-Content-Sha256=xxxxxxxx&X-Amz-Date=xxxxxxxx&X-Amz-Expires=300&X-Amz-Security-Token=xxxxxxxx& X-Amz-Signature=xxxxxxxx&X-Amz-SignedHeaders=host&x-id=GetObject#_=_",
            "format": "uri",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "organization": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the workspace.",
                "example": "My Company Workspace",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "workspace"
            }
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "state": {
            "description": "The current state of the export.",
            "enum": [
              "pending",
              "started",
              "finished",
              "error"
            ],
            "example": "started",
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "organization_export"
        }
      },
      "sdk__OrganizationExportCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nAn *organization_export* object represents a request to export the complete data of an Organization in JSON format.",
        "properties": {
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "download_url": {
            "description": "Download this URL to retrieve the full export of the organization\nin JSON format. It will be compressed in a gzip (.gz) container.\n\n*Note: May be null if the export is still in progress or\nfailed.  If present, this URL may only be valid for 1 hour from\nthe time of retrieval. You should avoid persisting this URL\nsomewhere and rather refresh on demand to ensure you do not keep\nstale URLs.*",
            "example": "https://asana-export-us-east-1.s3.us-east-1.amazonaws.com/2563645399633793/domain_export/7588024658887731/download/ domain_export_2563645399633793_7588024658887731_2023018-201726.json.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256& X-Amz-Content-Sha256=xxxxxxxx&X-Amz-Date=xxxxxxxx&X-Amz-Expires=300&X-Amz-Security-Token=xxxxxxxx& X-Amz-Signature=xxxxxxxx&X-Amz-SignedHeaders=host&x-id=GetObject#_=_",
            "format": "uri",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "organization": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the workspace.",
                "example": "My Company Workspace",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "workspace"
            }
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "state": {
            "description": "The current state of the export.",
            "enum": [
              "pending",
              "started",
              "finished",
              "error"
            ],
            "example": "started",
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "organization_export"
        }
      },
      "sdk__OrganizationExportRequest": {
        "description": "An *organization_export* request starts a job to export the complete data of the given Organization.",
        "properties": {
          "organization": {
            "description": "Globally unique identifier for the workspace or organization.",
            "example": "1331",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__OrganizationExportResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nAn *organization_export* object represents a request to export the complete data of an Organization in JSON format.",
        "properties": {
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "download_url": {
            "description": "Download this URL to retrieve the full export of the organization\nin JSON format. It will be compressed in a gzip (.gz) container.\n\n*Note: May be null if the export is still in progress or\nfailed.  If present, this URL may only be valid for 1 hour from\nthe time of retrieval. You should avoid persisting this URL\nsomewhere and rather refresh on demand to ensure you do not keep\nstale URLs.*",
            "example": "https://asana-export-us-east-1.s3.us-east-1.amazonaws.com/2563645399633793/domain_export/7588024658887731/download/ domain_export_2563645399633793_7588024658887731_2023018-201726.json.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256& X-Amz-Content-Sha256=xxxxxxxx&X-Amz-Date=xxxxxxxx&X-Amz-Expires=300&X-Amz-Security-Token=xxxxxxxx& X-Amz-Signature=xxxxxxxx&X-Amz-SignedHeaders=host&x-id=GetObject#_=_",
            "format": "uri",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "organization": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the workspace.",
                "example": "My Company Workspace",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "workspace"
            }
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "state": {
            "description": "The current state of the export.",
            "enum": [
              "pending",
              "started",
              "finished",
              "error"
            ],
            "example": "started",
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "organization_export"
        }
      },
      "sdk__OrganizationExportResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__OrganizationExportResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__PlaceholderCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *placeholder* object represents a placeholder in Asana that can be used to represent a placeholder user.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The placeholder's name.",
            "example": "Greg-Placeholder Sanchez",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "user"
        }
      },
      "sdk__PlaceholderRateCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *rate* is a monetary value assigned to a resource - `user` or `placeholder` - for a given `parent` object.",
        "properties": {
          "created_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "currency_code": {
            "description": "The currency code of the rate, set at the domain level.",
            "example": "USD",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          "rate": {
            "description": "The monetary value of the rate.",
            "example": 100,
            "type": "number"
          },
          "resource": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *placeholder* object represents a placeholder in Asana that can be used to represent a placeholder user.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The placeholder's name.",
                "example": "Greg-Placeholder Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "rate"
        }
      },
      "sdk__PortfolioAddItemRequest": {
        "properties": {
          "insert_after": {
            "description": "An id of an item in this portfolio. The new item will be added after the one specified here. `insert_before` and `insert_after` parameters cannot both be specified.",
            "example": "1331",
            "type": "string"
          },
          "insert_before": {
            "description": "An id of an item in this portfolio. The new item will be added before the one specified here. `insert_before` and `insert_after` parameters cannot both be specified.",
            "example": "1331",
            "type": "string"
          },
          "item": {
            "description": "The item to add to the portfolio.",
            "example": "1331",
            "type": "string"
          }
        },
        "required": [
          "item"
        ],
        "type": "object"
      },
      "sdk__PortfolioBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *portfolio* gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent [project status](/reference/project-statuses) update.\nPortfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.",
        "properties": {
          "archived": {
            "description": "[Opt In](/docs/inputoutput-options). True if the portfolio is archived, false if not. Archived portfolios do not show in the UI by default and may be treated differently for queries.",
            "example": false,
            "type": "boolean"
          },
          "color": {
            "description": "Color of the portfolio.",
            "enum": [
              "dark-pink",
              "dark-green",
              "dark-blue",
              "dark-red",
              "dark-teal",
              "dark-brown",
              "dark-orange",
              "dark-purple",
              "dark-warm-gray",
              "light-pink",
              "light-green",
              "light-blue",
              "light-red",
              "light-teal",
              "light-brown",
              "light-orange",
              "light-purple",
              "light-warm-gray"
            ],
            "example": "light-green",
            "type": "string"
          },
          "default_access_level": {
            "description": "The default access level when inviting new members to the portfolio",
            "enum": [
              "admin",
              "editor",
              "viewer"
            ],
            "example": "viewer",
            "type": "string"
          },
          "due_on": {
            "description": "The day on which this portfolio is due. This takes a date with format YYYY-MM-DD.",
            "example": "2019-09-15",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the portfolio.",
            "example": "Bug Portfolio",
            "type": "string"
          },
          "public": {
            "description": "Defines whether the portfolio is public to its workspace members. `true` if the portfolio is public to workspace members, `false` if it's visible only to members of the portfolio. New portfolios are private by default.",
            "example": false,
            "type": "boolean"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "enum": [
              "default_portfolio",
              "custom"
            ],
            "example": "default_portfolio",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_on": {
            "description": "The day on which work for this portfolio begins, or null if the portfolio has no start date. This takes a date with `YYYY-MM-DD` format. *Note: `due_on` must be present in the request when setting or unsetting the `start_on` parameter. Additionally, `start_on` and `due_on` cannot be the same date.*",
            "example": "2019-09-14",
            "format": "date",
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "portfolio"
        }
      },
      "sdk__PortfolioCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *portfolio* gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent [project status](/reference/project-statuses) update.\nPortfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the portfolio.",
            "example": "Bug Portfolio",
            "type": "string"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "enum": [
              "default_portfolio",
              "custom"
            ],
            "example": "default_portfolio",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "portfolio"
        }
      },
      "sdk__PortfolioDuplicateRequest": {
        "properties": {
          "include": {
            "description": "A comma-separated list of elements to include when duplicating a portfolio.\n\n**Auto-included fields (non-configurable)**\n- Custom field settings\n- Views (tabs)\n\n**Optional fields (configurable)**\n- description\n- members\n- permissions\n- templates\n- rules\n- child_projects\n- child_portfolios",
            "example": [
              "description,members,permissions,templates,rules,child_projects,child_portfolios"
            ],
            "type": "string"
          },
          "name": {
            "description": "The name of the new portfolio.",
            "example": "New Portfolio Name",
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "sdk__PortfolioItemCompact": {
        "anyOf": [
          {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *portfolio* gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent [project status](/reference/project-statuses) update.\nPortfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the portfolio.",
                "example": "Bug Portfolio",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_portfolio",
                  "custom"
                ],
                "example": "default_portfolio",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "portfolio"
            }
          }
        ]
      },
      "sdk__PortfolioItemCompactArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__PortfolioItemCompact"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__PortfolioMembershipBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object determines if a user is a member of a portfolio.",
        "properties": {
          "access_level": {
            "description": "Whether the member has admin, editor, or viewer access to the portfolio. Portfolios do not support commenter access yet.",
            "enum": [
              "admin",
              "editor",
              "viewer"
            ],
            "example": "admin",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the member",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of the member (team or user)",
                "example": "user",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "member"
            }
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *portfolio* gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent [project status](/reference/project-statuses) update.\nPortfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the portfolio.",
                "example": "Bug Portfolio",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_portfolio",
                  "custom"
                ],
                "example": "default_portfolio",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "portfolio"
            }
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "portfolio_membership"
        }
      },
      "sdk__PortfolioMembershipCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object determines if a user is a member of a portfolio.",
        "properties": {
          "access_level": {
            "description": "Whether the member has admin, editor, or viewer access to the portfolio. Portfolios do not support commenter access yet.",
            "enum": [
              "admin",
              "editor",
              "viewer"
            ],
            "example": "admin",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the member",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of the member (team or user)",
                "example": "user",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "member"
            }
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *portfolio* gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent [project status](/reference/project-statuses) update.\nPortfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the portfolio.",
                "example": "Bug Portfolio",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_portfolio",
                  "custom"
                ],
                "example": "default_portfolio",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "portfolio"
            }
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "portfolio_membership"
        }
      },
      "sdk__PortfolioMembershipCompactResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object determines if a user is a member of a portfolio.",
        "properties": {
          "access_level": {
            "description": "Whether the member has admin, editor, or viewer access to the portfolio. Portfolios do not support commenter access yet.",
            "enum": [
              "admin",
              "editor",
              "viewer"
            ],
            "example": "admin",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the member",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of the member (team or user)",
                "example": "user",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "member"
            }
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *portfolio* gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent [project status](/reference/project-statuses) update.\nPortfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the portfolio.",
                "example": "Bug Portfolio",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_portfolio",
                  "custom"
                ],
                "example": "default_portfolio",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "portfolio"
            }
          },
          "resource_subtype": {
            "description": "Type of the membership.",
            "example": "portfolio_membership",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "membership",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "portfolio_membership"
        }
      },
      "sdk__PortfolioMembershipResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object determines if a user is a member of a portfolio.",
        "properties": {
          "access_level": {
            "description": "Whether the member has admin, editor, or viewer access to the portfolio. Portfolios do not support commenter access yet.",
            "enum": [
              "admin",
              "editor",
              "viewer"
            ],
            "example": "admin",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the member",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of the member (team or user)",
                "example": "user",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "member"
            }
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *portfolio* gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent [project status](/reference/project-statuses) update.\nPortfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the portfolio.",
                "example": "Bug Portfolio",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_portfolio",
                  "custom"
                ],
                "example": "default_portfolio",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "portfolio"
            }
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "portfolio_membership"
        }
      },
      "sdk__PortfolioRemoveItemRequest": {
        "properties": {
          "item": {
            "description": "The item to remove from the portfolio.",
            "example": "1331",
            "type": "string"
          }
        },
        "required": [
          "item"
        ],
        "type": "object"
      },
      "sdk__PortfolioRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *portfolio* gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent [project status](/reference/project-statuses) update.\nPortfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.",
        "properties": {
          "archived": {
            "description": "[Opt In](/docs/inputoutput-options). True if the portfolio is archived, false if not. Archived portfolios do not show in the UI by default and may be treated differently for queries.",
            "example": false,
            "type": "boolean"
          },
          "color": {
            "description": "Color of the portfolio.",
            "enum": [
              "dark-pink",
              "dark-green",
              "dark-blue",
              "dark-red",
              "dark-teal",
              "dark-brown",
              "dark-orange",
              "dark-purple",
              "dark-warm-gray",
              "light-pink",
              "light-green",
              "light-blue",
              "light-red",
              "light-teal",
              "light-brown",
              "light-orange",
              "light-purple",
              "light-warm-gray"
            ],
            "example": "light-green",
            "type": "string"
          },
          "custom_type": {
            "description": "*Conditional:* You can only set custom_type if portfolio `resource_subtype` is `custom`. GID or globally-unique identifier of a portfolio's custom type. The type must be valid for portfolios, and some Asana-created custom types cannot be assigned via the API; attempting either returns an error explaining which condition failed.",
            "example": "12345",
            "nullable": true,
            "readOnly": false,
            "type": "string",
            "x-env-variable": true
          },
          "default_access_level": {
            "description": "The default access level when inviting new members to the portfolio",
            "enum": [
              "admin",
              "editor",
              "viewer"
            ],
            "example": "viewer",
            "type": "string"
          },
          "due_on": {
            "description": "The day on which this portfolio is due. This takes a date with format YYYY-MM-DD.",
            "example": "2019-09-15",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the portfolio.",
            "example": "Bug Portfolio",
            "type": "string"
          },
          "public": {
            "description": "Defines whether the portfolio is public to its workspace members. `true` if the portfolio is public to workspace members, `false` if it's visible only to members of the portfolio. New portfolios are private by default.",
            "example": false,
            "type": "boolean"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "enum": [
              "default_portfolio",
              "custom"
            ],
            "example": "default_portfolio",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_on": {
            "description": "The day on which work for this portfolio begins, or null if the portfolio has no start date. This takes a date with `YYYY-MM-DD` format. *Note: `due_on` must be present in the request when setting or unsetting the `start_on` parameter. Additionally, `start_on` and `due_on` cannot be the same date.*",
            "example": "2019-09-14",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "workspace": {
            "description": "*Create-only*. The workspace or organization that the portfolio belongs to.",
            "example": "167589",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "portfolio"
        }
      },
      "sdk__PortfolioResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *portfolio* gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent [project status](/reference/project-statuses) update.\nPortfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.",
        "properties": {
          "archived": {
            "description": "[Opt In](/docs/inputoutput-options). True if the portfolio is archived, false if not. Archived portfolios do not show in the UI by default and may be treated differently for queries.",
            "example": false,
            "type": "boolean"
          },
          "color": {
            "description": "Color of the portfolio.",
            "enum": [
              "dark-pink",
              "dark-green",
              "dark-blue",
              "dark-red",
              "dark-teal",
              "dark-brown",
              "dark-orange",
              "dark-purple",
              "dark-warm-gray",
              "light-pink",
              "light-green",
              "light-blue",
              "light-red",
              "light-teal",
              "light-brown",
              "light-orange",
              "light-purple",
              "light-warm-gray"
            ],
            "example": "light-green",
            "type": "string"
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "created_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "current_status_update": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *status update* is an update on the progress of a particular project, portfolio, or goal, and is sent out to all of its parent's followers when created. These updates include both text describing the update and a `status_type` intended to represent the overall state of the object.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *status update* is an update on the progress of a particular project, portfolio, or goal, and is sent out to all of its parent's followers when created. These updates include both text describing the update and a `status_type` intended to represent the overall state of the object.\nThe latest `status_update` posted to this portfolio.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe `resource_subtype`s for `status` objects represent the type of their parent.",
                "enum": [
                  "project_status_update",
                  "portfolio_status_update",
                  "goal_status_update"
                ],
                "example": "project_status_update",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              },
              "title": {
                "description": "The title of the status update.",
                "example": "Status Update - Jun 15",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "status_update"
            }
          },
          "custom_field_settings": {
            "description": "Array of custom field definitions that are enabled for the portfolio. These represent which custom fields are available to be used on items within the portfolio, but do not include any values.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields Settings objects represent the many-to-many join of the Custom Field and Project as well as stores information that is relevant to that particular pairing.",
              "properties": {
                "custom_field": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.\nThe custom field that is applied to the `parent`.",
                  "properties": {
                    "asana_created_field": {
                      "description": "*Conditional*. A unique identifier to associate this field with the template source of truth.",
                      "enum": [
                        "a_v_requirements",
                        "account_name",
                        "actionable",
                        "align_shipping_link",
                        "align_status",
                        "allotted_time",
                        "appointment",
                        "approval_stage",
                        "approved",
                        "article_series",
                        "board_committee",
                        "browser",
                        "campaign_audience",
                        "campaign_project_status",
                        "campaign_regions",
                        "channel_primary",
                        "client_topic_type",
                        "complete_by",
                        "contact",
                        "contact_email_address",
                        "content_channels",
                        "content_channels_needed",
                        "content_stage",
                        "content_type",
                        "contract",
                        "contract_status",
                        "cost",
                        "creation_stage",
                        "creative_channel",
                        "creative_needed",
                        "creative_needs",
                        "data_sensitivity",
                        "deal_size",
                        "delivery_appt",
                        "delivery_appt_date",
                        "department",
                        "department_responsible",
                        "design_request_needed",
                        "design_request_type",
                        "discussion_category",
                        "do_this_task",
                        "editorial_content_status",
                        "editorial_content_tag",
                        "editorial_content_type",
                        "effort",
                        "effort_level",
                        "est_completion_date",
                        "estimated_time",
                        "estimated_value",
                        "expected_cost",
                        "external_steps_needed",
                        "favorite_idea",
                        "feedback_type",
                        "financial",
                        "funding_amount",
                        "grant_application_process",
                        "hiring_candidate_status",
                        "idea_status",
                        "ids_link",
                        "ids_patient_link",
                        "implementation_stage",
                        "insurance",
                        "interview_area",
                        "interview_question_score",
                        "itero_scan_link",
                        "job_s_applied_to",
                        "lab",
                        "launch_status",
                        "lead_status",
                        "localization_language",
                        "localization_market_team",
                        "localization_status",
                        "meeting_minutes",
                        "meeting_needed",
                        "minutes",
                        "mrr",
                        "must_localize",
                        "name_of_foundation",
                        "need_to_follow_up",
                        "next_appointment",
                        "next_steps_sales",
                        "num_people",
                        "number_of_user_reports",
                        "office_location",
                        "onboarding_activity",
                        "owner",
                        "participants_needed",
                        "patient_date_of_birth",
                        "patient_email",
                        "patient_phone",
                        "patient_status",
                        "phone_number",
                        "planning_category",
                        "point_of_contact",
                        "position",
                        "post_format",
                        "prescription",
                        "priority",
                        "priority_level",
                        "product",
                        "product_stage",
                        "progress",
                        "project_size",
                        "project_status",
                        "proposed_budget",
                        "publish_status",
                        "reason_for_scan",
                        "referral",
                        "request_type",
                        "research_status",
                        "responsible_department",
                        "responsible_team",
                        "risk_assessment_status",
                        "room_name",
                        "sales_counterpart",
                        "sentiment",
                        "shipping_link",
                        "social_channels",
                        "stage",
                        "status",
                        "status_design",
                        "status_of_initiative",
                        "system_setup",
                        "task_progress",
                        "team",
                        "team_marketing",
                        "team_responsible",
                        "time_it_takes_to_complete_tasks",
                        "timeframe",
                        "treatment_type",
                        "type_work_requests_it",
                        "use_agency",
                        "user_name",
                        "vendor_category",
                        "vendor_type",
                        "word_count",
                        null
                      ],
                      "example": "priority",
                      "nullable": true,
                      "readOnly": true,
                      "type": "string"
                    },
                    "created_by": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                      "nullable": true,
                      "properties": {
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "*Read-only except when same user as requester*. The user's name.",
                          "example": "Greg Sanchez",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "user"
                      }
                    },
                    "currency_code": {
                      "description": "ISO 4217 currency code to format this custom field. This will be null if the `format` is not `currency`.",
                      "example": "EUR",
                      "nullable": true,
                      "type": "string"
                    },
                    "custom_label": {
                      "description": "This is the string that appears next to the custom field value. This will be null if the `format` is not `custom`.",
                      "example": "gold pieces",
                      "nullable": true,
                      "type": "string"
                    },
                    "custom_label_position": {
                      "description": "Only relevant for custom fields with `custom` format. This depicts where to place the custom label. This will be null if the `format` is not `custom`.",
                      "enum": [
                        "prefix",
                        "suffix",
                        null
                      ],
                      "example": "suffix",
                      "nullable": true,
                      "type": "string"
                    },
                    "date_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                      "nullable": true,
                      "properties": {
                        "date": {
                          "description": "A string representing the date in YYYY-MM-DD format.",
                          "example": "2024-08-23",
                          "type": "string"
                        },
                        "date_time": {
                          "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                          "example": "2024-08-23T22:00:00.000Z",
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    "default_access_level": {
                      "description": "The default access level when inviting new members to the custom field. This isn't applied when the `privacy_setting` is `private`, or the user is a guest. For local fields in a project or portfolio, the user must additionally have permission to modify the container itself.",
                      "enum": [
                        "admin",
                        "editor",
                        "user"
                      ],
                      "example": "user",
                      "type": "string"
                    },
                    "description": {
                      "description": "[Opt In](/docs/inputoutput-options). The description of the custom field.",
                      "example": "Development team priority",
                      "type": "string"
                    },
                    "display_value": {
                      "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                      "example": "blue",
                      "nullable": true,
                      "readOnly": true,
                      "type": "string"
                    },
                    "enabled": {
                      "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                      "example": true,
                      "readOnly": true,
                      "type": "boolean"
                    },
                    "enum_options": {
                      "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                        "properties": {
                          "color": {
                            "description": "The color of the enum option. Defaults to `none`.",
                            "example": "blue",
                            "type": "string"
                          },
                          "enabled": {
                            "description": "Whether or not the enum option is a selectable value for the custom field.",
                            "example": true,
                            "type": "boolean"
                          },
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "The name of the enum option.",
                            "example": "Low",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object",
                        "x-docs-overrides": {
                          "properties.resource_type.example": "enum_option"
                        }
                      },
                      "type": "array"
                    },
                    "enum_value": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                      "nullable": true,
                      "properties": {
                        "color": {
                          "description": "The color of the enum option. Defaults to `none`.",
                          "example": "blue",
                          "type": "string"
                        },
                        "enabled": {
                          "description": "Whether or not the enum option is a selectable value for the custom field.",
                          "example": true,
                          "type": "boolean"
                        },
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "The name of the enum option.",
                          "example": "Low",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "enum_option"
                      }
                    },
                    "format": {
                      "description": "The format of this custom field.",
                      "enum": [
                        "currency",
                        "identifier",
                        "percentage",
                        "custom",
                        "duration",
                        "none"
                      ],
                      "example": "custom",
                      "type": "string"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "has_notifications_enabled": {
                      "description": "*Conditional*. This flag describes whether a follower of a task with this field should receive inbox notifications from changes to this field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "html_text_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `text`. This is the HTML representation of the text value of a custom field, corresponding to the `text_value` plain-text field. See [rich text](/docs/rich-text#reading-rich-text).",
                      "example": "<body>Some Value</body>",
                      "nullable": true,
                      "readOnly": true,
                      "type": "string"
                    },
                    "id_prefix": {
                      "description": "This field is the unique custom ID string for the custom field.",
                      "example": "ID",
                      "nullable": true,
                      "type": "string"
                    },
                    "input_restrictions": {
                      "example": [
                        "task"
                      ],
                      "items": {
                        "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                        "enum": [
                          "task",
                          "project",
                          "portfolio",
                          "goal"
                        ],
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "is_formula_field": {
                      "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                      "example": false,
                      "type": "boolean"
                    },
                    "is_global_to_workspace": {
                      "description": "This flag describes whether this custom field is available to every container in the workspace. Before project-specific custom fields, this field was always true.",
                      "example": true,
                      "readOnly": true,
                      "type": "boolean"
                    },
                    "is_lookup_field": {
                      "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                      "example": false,
                      "type": "boolean"
                    },
                    "is_value_read_only": {
                      "description": "*Conditional*. This flag describes whether a custom field is read only.",
                      "example": false,
                      "type": "boolean"
                    },
                    "multi_enum_values": {
                      "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                        "properties": {
                          "color": {
                            "description": "The color of the enum option. Defaults to `none`.",
                            "example": "blue",
                            "type": "string"
                          },
                          "enabled": {
                            "description": "Whether or not the enum option is a selectable value for the custom field.",
                            "example": true,
                            "type": "boolean"
                          },
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "The name of the enum option.",
                            "example": "Low",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object",
                        "x-docs-overrides": {
                          "properties.resource_type.example": "enum_option"
                        }
                      },
                      "type": "array"
                    },
                    "name": {
                      "description": "The name of the custom field.",
                      "example": "Status",
                      "type": "string"
                    },
                    "number_value": {
                      "description": "*Conditional*. This number is the value of a `number` custom field.",
                      "example": 5.2,
                      "nullable": true,
                      "type": "number"
                    },
                    "people_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `people`. This array of [compact user](/reference/users) objects reflects the values of a `people` custom field.",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                        "properties": {
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "*Read-only except when same user as requester*. The user's name.",
                            "example": "Greg Sanchez",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object",
                        "x-docs-overrides": {
                          "properties.resource_type.example": "user"
                        }
                      },
                      "type": "array"
                    },
                    "precision": {
                      "description": "Only relevant for custom fields of type `Number`. This field dictates the number of places after the decimal to round to, i.e. 0 is integer values, 1 rounds to the nearest tenth, and so on. Must be between 0 and 6, inclusive.\nFor percentage format, this may be unintuitive, as a value of 0.25 has a precision of 0, while a value of 0.251 has a precision of 1. This is due to 0.25 being displayed as 25%.\nThe identifier format will always have a precision of 0.",
                      "example": 2,
                      "type": "integer"
                    },
                    "privacy_setting": {
                      "description": "The privacy setting of the custom field. *Note: Administrators in your organization may restrict the values of `privacy_setting`.*",
                      "enum": [
                        "public_with_guests",
                        "public",
                        "private"
                      ],
                      "example": "public_with_guests",
                      "type": "string"
                    },
                    "reference_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of objects reflects the values of a `reference` custom field.",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.",
                        "properties": {
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "The name of the object.",
                            "example": "Bug Task",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "representation_type": {
                      "description": "This field tells the type of the custom field.",
                      "enum": [
                        "text",
                        "enum",
                        "multi_enum",
                        "number",
                        "date",
                        "people",
                        "formula",
                        "custom_id",
                        "reference"
                      ],
                      "example": "number",
                      "readOnly": true,
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The type of the custom field. Must be one of the given values.\n",
                      "enum": [
                        "text",
                        "enum",
                        "multi_enum",
                        "number",
                        "date",
                        "people",
                        "reference"
                      ],
                      "example": "text",
                      "readOnly": true,
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    },
                    "text_value": {
                      "description": "*Conditional*. This string is the value of a `text` custom field.",
                      "example": "Some Value",
                      "nullable": true,
                      "type": "string"
                    },
                    "type": {
                      "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                      "enum": [
                        "text",
                        "enum",
                        "multi_enum",
                        "number",
                        "date",
                        "people",
                        "reference"
                      ],
                      "readOnly": true,
                      "type": "string"
                    }
                  },
                  "readOnly": true,
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "custom_field"
                  }
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "is_important": {
                  "description": "`is_important` is used in the Asana web application to determine if this custom field is displayed in the list/grid view of a project or portfolio.",
                  "example": false,
                  "readOnly": true,
                  "type": "boolean"
                },
                "parent": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\nThe parent to which the custom field is applied. This can be a project or portfolio and indicates that the tasks or projects that the parent contains may be given custom field values for this custom field.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "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.",
                      "example": "Stuff to buy",
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                      "enum": [
                        "default_project",
                        "custom"
                      ],
                      "example": "default_project",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "readOnly": true,
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "project"
                  }
                },
                "project": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\n*Deprecated: new integrations should prefer the `parent` field.* The id of the project that this custom field settings refers to.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "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.",
                      "example": "Stuff to buy",
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                      "enum": [
                        "default_project",
                        "custom"
                      ],
                      "example": "default_project",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "readOnly": true,
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "project"
                  }
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "custom_field_setting"
              }
            },
            "type": "array"
          },
          "custom_fields": {
            "description": "Array of custom field values applied directly to the portfolio itself. These represent the values set on the portfolio, not the fields available for items in the portfolio.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.",
              "properties": {
                "date_value": {
                  "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                  "nullable": true,
                  "properties": {
                    "date": {
                      "description": "A string representing the date in YYYY-MM-DD format.",
                      "example": "2024-08-23",
                      "type": "string"
                    },
                    "date_time": {
                      "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                      "example": "2024-08-23T22:00:00.000Z",
                      "type": "string"
                    }
                  },
                  "type": "object"
                },
                "display_value": {
                  "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                  "example": "blue",
                  "nullable": true,
                  "readOnly": true,
                  "type": "string"
                },
                "enabled": {
                  "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                  "example": true,
                  "readOnly": true,
                  "type": "boolean"
                },
                "enum_options": {
                  "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                  "items": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                    "properties": {
                      "color": {
                        "description": "The color of the enum option. Defaults to `none`.",
                        "example": "blue",
                        "type": "string"
                      },
                      "enabled": {
                        "description": "Whether or not the enum option is a selectable value for the custom field.",
                        "example": true,
                        "type": "boolean"
                      },
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "The name of the enum option.",
                        "example": "Low",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "enum_option"
                    }
                  },
                  "type": "array"
                },
                "enum_value": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                  "nullable": true,
                  "properties": {
                    "color": {
                      "description": "The color of the enum option. Defaults to `none`.",
                      "example": "blue",
                      "type": "string"
                    },
                    "enabled": {
                      "description": "Whether or not the enum option is a selectable value for the custom field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the enum option.",
                      "example": "Low",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "enum_option"
                  }
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "id_prefix": {
                  "description": "This field is the unique custom ID string for the custom field.",
                  "example": "ID",
                  "nullable": true,
                  "type": "string"
                },
                "input_restrictions": {
                  "example": [
                    "task"
                  ],
                  "items": {
                    "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                    "enum": [
                      "task",
                      "project",
                      "portfolio",
                      "goal"
                    ],
                    "type": "string"
                  },
                  "type": "array"
                },
                "is_formula_field": {
                  "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                  "example": false,
                  "type": "boolean"
                },
                "is_lookup_field": {
                  "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                  "example": false,
                  "type": "boolean"
                },
                "multi_enum_values": {
                  "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                  "items": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                    "properties": {
                      "color": {
                        "description": "The color of the enum option. Defaults to `none`.",
                        "example": "blue",
                        "type": "string"
                      },
                      "enabled": {
                        "description": "Whether or not the enum option is a selectable value for the custom field.",
                        "example": true,
                        "type": "boolean"
                      },
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "The name of the enum option.",
                        "example": "Low",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "enum_option"
                    }
                  },
                  "type": "array"
                },
                "name": {
                  "description": "The name of the custom field.",
                  "example": "Status",
                  "type": "string"
                },
                "number_value": {
                  "description": "*Conditional*. This number is the value of a `number` custom field.",
                  "example": 5.2,
                  "nullable": true,
                  "type": "number"
                },
                "representation_type": {
                  "description": "This field tells the type of the custom field.",
                  "enum": [
                    "text",
                    "enum",
                    "multi_enum",
                    "number",
                    "date",
                    "people",
                    "formula",
                    "custom_id",
                    "reference"
                  ],
                  "example": "number",
                  "readOnly": true,
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                },
                "text_value": {
                  "description": "*Conditional*. This string is the value of a `text` custom field.",
                  "example": "Some Value",
                  "nullable": true,
                  "type": "string"
                },
                "type": {
                  "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                  "enum": [
                    "text",
                    "enum",
                    "multi_enum",
                    "number",
                    "date",
                    "people",
                    "reference"
                  ],
                  "readOnly": true,
                  "type": "string"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "custom_field"
              }
            },
            "type": "array"
          },
          "custom_type": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Types extend the types of Asana Objects.",
            "nullable": true,
            "properties": {
              "asana_created_type_identifier": {
                "description": "*Read-only*. A stable identifier present when this custom type was created by Asana as part of an Asana product (for example, a Command ticket type or a Service queue type). `null` for custom types created by users, and for Asana-created types that do not have a public identifier yet. New values may be added over time as Asana products introduce new types; integrations should tolerate unrecognized values.",
                "enum": [
                  "COMMAND_TICKET",
                  "COMMAND_RELEASE",
                  "COMMAND_TEAMSPACE",
                  "SERVICE_TICKET",
                  "SERVICE_CONVERSATION",
                  "SERVICE_QUEUE"
                ],
                "example": "COMMAND_TICKET",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the custom type.",
                "example": "Bug ticket",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "custom_type"
            }
          },
          "default_access_level": {
            "description": "The default access level when inviting new members to the portfolio",
            "enum": [
              "admin",
              "editor",
              "viewer"
            ],
            "example": "viewer",
            "type": "string"
          },
          "due_on": {
            "description": "The day on which this portfolio is due. This takes a date with format YYYY-MM-DD.",
            "example": "2019-09-15",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "members": {
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "*Read-only except when same user as requester*. The user's name.",
                  "example": "Greg Sanchez",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "user"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "name": {
            "description": "The name of the portfolio.",
            "example": "Bug Portfolio",
            "type": "string"
          },
          "owner": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "permalink_url": {
            "description": "A url that points directly to the object within Asana.",
            "example": "https://app.asana.com/0/resource/123456789/list",
            "readOnly": true,
            "type": "string"
          },
          "privacy_setting": {
            "description": "The privacy setting of the portfolio. *Note: Administrators in your organization may restrict the values of `privacy_setting`.*",
            "enum": [
              "public_to_domain",
              "members_only"
            ],
            "example": "members_only",
            "type": "string"
          },
          "project_templates": {
            "description": "Array of project templates that are in the portfolio",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project template* is an object that allows new projects to be created with a predefined setup, which may include tasks, sections, Rules, etc. It simplifies the process of running a workflow that involves a similar set of work every time.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "Name of the project template.",
                  "example": "Packing list",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "project_template"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "public": {
            "description": "Defines whether the portfolio is public to its workspace members. `true` if the portfolio is public to workspace members, `false` if it's visible only to members of the portfolio. New portfolios are private by default.",
            "example": false,
            "type": "boolean"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "enum": [
              "default_portfolio",
              "custom"
            ],
            "example": "default_portfolio",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_on": {
            "description": "The day on which work for this portfolio begins, or null if the portfolio has no start date. This takes a date with `YYYY-MM-DD` format. *Note: `due_on` must be present in the request when setting or unsetting the `start_on` parameter. Additionally, `start_on` and `due_on` cannot be the same date.*",
            "example": "2019-09-14",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "workspace": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.\n*Create-only*. The workspace or organization that the portfolio belongs to.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the workspace.",
                "example": "My Company Workspace",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "workspace"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "portfolio"
        }
      },
      "sdk__PortfolioResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__PortfolioResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__PortfolioResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__PortfolioResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__PortfolioUpdateRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *portfolio* gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent [project status](/reference/project-statuses) update.\nPortfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.",
        "properties": {
          "archived": {
            "description": "[Opt In](/docs/inputoutput-options). True if the portfolio is archived, false if not. Archived portfolios do not show in the UI by default and may be treated differently for queries.",
            "example": false,
            "type": "boolean"
          },
          "color": {
            "description": "Color of the portfolio.",
            "enum": [
              "dark-pink",
              "dark-green",
              "dark-blue",
              "dark-red",
              "dark-teal",
              "dark-brown",
              "dark-orange",
              "dark-purple",
              "dark-warm-gray",
              "light-pink",
              "light-green",
              "light-blue",
              "light-red",
              "light-teal",
              "light-brown",
              "light-orange",
              "light-purple",
              "light-warm-gray"
            ],
            "example": "light-green",
            "type": "string"
          },
          "custom_fields": {
            "additionalProperties": {
              "description": "\"{custom_field_gid}\" => Value (can be text, enum GID, a number, etc.). For date, use format \"YYYY-MM-DD\" (e.g., 2019-09-15). For date-time, use ISO 8601 date string in UTC (e.g., 2019-09-15T02:06:58.147Z).",
              "type": "string"
            },
            "description": "An object where each key is the GID of a custom field and its corresponding value is either an enum GID, string, number, or object (depending on the custom field type). See the [custom fields guide](/docs/custom-fields-guide) for details on creating and updating custom field values.",
            "example": {
              "4578152156": "Not Started",
              "5678904321": "On Hold"
            },
            "type": "object"
          },
          "custom_type": {
            "description": "*Conditional:* You can only set custom_type if portfolio `resource_subtype` is `custom`. GID or globally-unique identifier of a portfolio's custom type. The type must be valid for portfolios, and some Asana-created custom types cannot be assigned via the API; attempting either returns an error explaining which condition failed.",
            "example": "12345",
            "nullable": true,
            "readOnly": false,
            "type": "string",
            "x-env-variable": true
          },
          "default_access_level": {
            "description": "The default access level when inviting new members to the portfolio",
            "enum": [
              "admin",
              "editor",
              "viewer"
            ],
            "example": "viewer",
            "type": "string"
          },
          "due_on": {
            "description": "The day on which this portfolio is due. This takes a date with format YYYY-MM-DD.",
            "example": "2019-09-15",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_custom_fields": {
            "additionalProperties": {
              "description": "\"{custom_field_gid}\" => HTML string (e.g., \"<body>Text content</body>\")",
              "type": "string"
            },
            "description": "An object where each key is the GID of a text custom field and the corresponding value is a rich text HTML string. Only text-type custom fields support this parameter. Values must be wrapped in <body></body> tags. See the [custom fields guide](/docs/custom-fields-guide) and [rich text](/docs/rich-text) for details on supported formatting.",
            "example": {
              "4578152156": "<body><code>Code block</code></body>",
              "5678904321": "<body><strong>Bold text</strong></body>"
            },
            "type": "object"
          },
          "name": {
            "description": "The name of the portfolio.",
            "example": "Bug Portfolio",
            "type": "string"
          },
          "public": {
            "description": "Defines whether the portfolio is public to its workspace members. `true` if the portfolio is public to workspace members, `false` if it's visible only to members of the portfolio. New portfolios are private by default.",
            "example": false,
            "type": "boolean"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "enum": [
              "default_portfolio",
              "custom"
            ],
            "example": "default_portfolio",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_on": {
            "description": "The day on which work for this portfolio begins, or null if the portfolio has no start date. This takes a date with `YYYY-MM-DD` format. *Note: `due_on` must be present in the request when setting or unsetting the `start_on` parameter. Additionally, `start_on` and `due_on` cannot be the same date.*",
            "example": "2019-09-14",
            "format": "date",
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "portfolio"
        }
      },
      "sdk__Preview": {
        "description": "A collection of rich text that will be displayed as a preview to another app.\n\nThis is read-only except for a small group of whitelisted apps.",
        "properties": {
          "fallback": {
            "description": "Some fallback text to display if unable to display the full preview.",
            "example": "Greg: Great! I like this idea.\\n\\nhttps//a_company.slack.com/archives/ABCDEFG/12345678",
            "type": "string"
          },
          "footer": {
            "description": "Text to display in the footer.",
            "example": "Mar 17, 2019 1:25 PM",
            "type": "string"
          },
          "header": {
            "description": "Text to display in the header.",
            "example": "Asana for Slack",
            "type": "string"
          },
          "header_link": {
            "description": "Where the header will link to.",
            "example": "https://asana.comn/apps/slack",
            "type": "string"
          },
          "html_text": {
            "description": "HTML formatted text for the body of the preview. See [rich text](/docs/rich-text#reading-rich-text).",
            "example": "<body>Great! I like this idea.</body>",
            "type": "string"
          },
          "text": {
            "description": "Text for the body of the preview.",
            "example": "Great! I like this idea.",
            "type": "string"
          },
          "title": {
            "description": "Text to display as the title.",
            "example": "Greg",
            "type": "string"
          },
          "title_link": {
            "description": "Where to title will link to.",
            "example": "https://asana.slack.com/archives/ABCDEFG/12345678",
            "type": "string"
          }
        },
        "readOnly": true,
        "type": "object"
      },
      "sdk__ProjectBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
        "properties": {
          "archived": {
            "description": "True if the project is archived, false if not. Archived projects do not show in the UI by default and may be treated differently for queries.",
            "example": false,
            "type": "boolean"
          },
          "color": {
            "description": "Color of the project.",
            "enum": [
              "dark-pink",
              "dark-green",
              "dark-blue",
              "dark-red",
              "dark-teal",
              "dark-brown",
              "dark-orange",
              "dark-purple",
              "dark-warm-gray",
              "light-pink",
              "light-green",
              "light-blue",
              "light-red",
              "light-teal",
              "light-brown",
              "light-orange",
              "light-purple",
              "light-warm-gray",
              "none",
              null
            ],
            "example": "light-green",
            "nullable": true,
            "type": "string"
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "current_status": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\n*Deprecated: new integrations should prefer the `status_update` resource.*\nA *project status* is an update on the progress of a particular project, and is sent out to all project followers when created. These updates include both text describing the update and a color code intended to represent the overall state of the project: \"green\" for projects that are on track, \"yellow\" for projects at risk, and \"red\" for projects that are behind.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\n*Deprecated: new integrations should prefer the `status_update` resource.*\nA *project status* is an update on the progress of a particular project, and is sent out to all project followers when created. These updates include both text describing the update and a color code intended to represent the overall state of the project: \"green\" for projects that are on track, \"yellow\" for projects at risk, and \"red\" for projects that are behind.\n*Deprecated: new integrations should prefer the `current_status_update` resource.*",
            "nullable": true,
            "properties": {
              "author": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "color": {
                "description": "The color associated with the status update.",
                "enum": [
                  "green",
                  "yellow",
                  "red",
                  "blue",
                  "complete"
                ],
                "type": "string"
              },
              "created_at": {
                "description": "The time at which this resource was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "created_by": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "html_text": {
                "description": "[Opt In](/docs/inputoutput-options). The text content of the status update with formatting as HTML. See [rich text](/docs/rich-text).",
                "example": "<body>The project <strong>is</strong> moving forward according to plan...</body>",
                "type": "string"
              },
              "modified_at": {
                "description": "The time at which this project status was last modified.\n*Note: This does not currently reflect any changes in associations such as comments that may have been added or removed from the project status.*",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              },
              "text": {
                "description": "The text content of the status update.",
                "example": "The project is moving forward according to plan...",
                "type": "string"
              },
              "title": {
                "description": "The title of the project status update.",
                "example": "Status Update - Jun 15",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project_status"
            }
          },
          "current_status_update": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *status update* is an update on the progress of a particular project, portfolio, or goal, and is sent out to all of its parent's followers when created. These updates include both text describing the update and a `status_type` intended to represent the overall state of the object.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *status update* is an update on the progress of a particular project, portfolio, or goal, and is sent out to all of its parent's followers when created. These updates include both text describing the update and a `status_type` intended to represent the overall state of the object.\nThe latest `status_update` posted to this project.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe `resource_subtype`s for `status` objects represent the type of their parent.",
                "enum": [
                  "project_status_update",
                  "portfolio_status_update",
                  "goal_status_update"
                ],
                "example": "project_status_update",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              },
              "title": {
                "description": "The title of the status update.",
                "example": "Status Update - Jun 15",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "status_update"
            }
          },
          "custom_field_settings": {
            "description": "Array of custom field definitions that are enabled for the project. These represent which custom fields are available to be used on tasks within the project, but do not include any values.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields Settings objects represent the many-to-many join of the Custom Field and Project as well as stores information that is relevant to that particular pairing.",
              "properties": {
                "custom_field": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.\nThe custom field that is applied to the `parent`.",
                  "properties": {
                    "asana_created_field": {
                      "description": "*Conditional*. A unique identifier to associate this field with the template source of truth.",
                      "enum": [
                        "a_v_requirements",
                        "account_name",
                        "actionable",
                        "align_shipping_link",
                        "align_status",
                        "allotted_time",
                        "appointment",
                        "approval_stage",
                        "approved",
                        "article_series",
                        "board_committee",
                        "browser",
                        "campaign_audience",
                        "campaign_project_status",
                        "campaign_regions",
                        "channel_primary",
                        "client_topic_type",
                        "complete_by",
                        "contact",
                        "contact_email_address",
                        "content_channels",
                        "content_channels_needed",
                        "content_stage",
                        "content_type",
                        "contract",
                        "contract_status",
                        "cost",
                        "creation_stage",
                        "creative_channel",
                        "creative_needed",
                        "creative_needs",
                        "data_sensitivity",
                        "deal_size",
                        "delivery_appt",
                        "delivery_appt_date",
                        "department",
                        "department_responsible",
                        "design_request_needed",
                        "design_request_type",
                        "discussion_category",
                        "do_this_task",
                        "editorial_content_status",
                        "editorial_content_tag",
                        "editorial_content_type",
                        "effort",
                        "effort_level",
                        "est_completion_date",
                        "estimated_time",
                        "estimated_value",
                        "expected_cost",
                        "external_steps_needed",
                        "favorite_idea",
                        "feedback_type",
                        "financial",
                        "funding_amount",
                        "grant_application_process",
                        "hiring_candidate_status",
                        "idea_status",
                        "ids_link",
                        "ids_patient_link",
                        "implementation_stage",
                        "insurance",
                        "interview_area",
                        "interview_question_score",
                        "itero_scan_link",
                        "job_s_applied_to",
                        "lab",
                        "launch_status",
                        "lead_status",
                        "localization_language",
                        "localization_market_team",
                        "localization_status",
                        "meeting_minutes",
                        "meeting_needed",
                        "minutes",
                        "mrr",
                        "must_localize",
                        "name_of_foundation",
                        "need_to_follow_up",
                        "next_appointment",
                        "next_steps_sales",
                        "num_people",
                        "number_of_user_reports",
                        "office_location",
                        "onboarding_activity",
                        "owner",
                        "participants_needed",
                        "patient_date_of_birth",
                        "patient_email",
                        "patient_phone",
                        "patient_status",
                        "phone_number",
                        "planning_category",
                        "point_of_contact",
                        "position",
                        "post_format",
                        "prescription",
                        "priority",
                        "priority_level",
                        "product",
                        "product_stage",
                        "progress",
                        "project_size",
                        "project_status",
                        "proposed_budget",
                        "publish_status",
                        "reason_for_scan",
                        "referral",
                        "request_type",
                        "research_status",
                        "responsible_department",
                        "responsible_team",
                        "risk_assessment_status",
                        "room_name",
                        "sales_counterpart",
                        "sentiment",
                        "shipping_link",
                        "social_channels",
                        "stage",
                        "status",
                        "status_design",
                        "status_of_initiative",
                        "system_setup",
                        "task_progress",
                        "team",
                        "team_marketing",
                        "team_responsible",
                        "time_it_takes_to_complete_tasks",
                        "timeframe",
                        "treatment_type",
                        "type_work_requests_it",
                        "use_agency",
                        "user_name",
                        "vendor_category",
                        "vendor_type",
                        "word_count",
                        null
                      ],
                      "example": "priority",
                      "nullable": true,
                      "readOnly": true,
                      "type": "string"
                    },
                    "created_by": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                      "nullable": true,
                      "properties": {
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "*Read-only except when same user as requester*. The user's name.",
                          "example": "Greg Sanchez",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "user"
                      }
                    },
                    "currency_code": {
                      "description": "ISO 4217 currency code to format this custom field. This will be null if the `format` is not `currency`.",
                      "example": "EUR",
                      "nullable": true,
                      "type": "string"
                    },
                    "custom_label": {
                      "description": "This is the string that appears next to the custom field value. This will be null if the `format` is not `custom`.",
                      "example": "gold pieces",
                      "nullable": true,
                      "type": "string"
                    },
                    "custom_label_position": {
                      "description": "Only relevant for custom fields with `custom` format. This depicts where to place the custom label. This will be null if the `format` is not `custom`.",
                      "enum": [
                        "prefix",
                        "suffix",
                        null
                      ],
                      "example": "suffix",
                      "nullable": true,
                      "type": "string"
                    },
                    "date_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                      "nullable": true,
                      "properties": {
                        "date": {
                          "description": "A string representing the date in YYYY-MM-DD format.",
                          "example": "2024-08-23",
                          "type": "string"
                        },
                        "date_time": {
                          "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                          "example": "2024-08-23T22:00:00.000Z",
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    "default_access_level": {
                      "description": "The default access level when inviting new members to the custom field. This isn't applied when the `privacy_setting` is `private`, or the user is a guest. For local fields in a project or portfolio, the user must additionally have permission to modify the container itself.",
                      "enum": [
                        "admin",
                        "editor",
                        "user"
                      ],
                      "example": "user",
                      "type": "string"
                    },
                    "description": {
                      "description": "[Opt In](/docs/inputoutput-options). The description of the custom field.",
                      "example": "Development team priority",
                      "type": "string"
                    },
                    "display_value": {
                      "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                      "example": "blue",
                      "nullable": true,
                      "readOnly": true,
                      "type": "string"
                    },
                    "enabled": {
                      "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                      "example": true,
                      "readOnly": true,
                      "type": "boolean"
                    },
                    "enum_options": {
                      "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                        "properties": {
                          "color": {
                            "description": "The color of the enum option. Defaults to `none`.",
                            "example": "blue",
                            "type": "string"
                          },
                          "enabled": {
                            "description": "Whether or not the enum option is a selectable value for the custom field.",
                            "example": true,
                            "type": "boolean"
                          },
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "The name of the enum option.",
                            "example": "Low",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object",
                        "x-docs-overrides": {
                          "properties.resource_type.example": "enum_option"
                        }
                      },
                      "type": "array"
                    },
                    "enum_value": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                      "nullable": true,
                      "properties": {
                        "color": {
                          "description": "The color of the enum option. Defaults to `none`.",
                          "example": "blue",
                          "type": "string"
                        },
                        "enabled": {
                          "description": "Whether or not the enum option is a selectable value for the custom field.",
                          "example": true,
                          "type": "boolean"
                        },
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "The name of the enum option.",
                          "example": "Low",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "enum_option"
                      }
                    },
                    "format": {
                      "description": "The format of this custom field.",
                      "enum": [
                        "currency",
                        "identifier",
                        "percentage",
                        "custom",
                        "duration",
                        "none"
                      ],
                      "example": "custom",
                      "type": "string"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "has_notifications_enabled": {
                      "description": "*Conditional*. This flag describes whether a follower of a task with this field should receive inbox notifications from changes to this field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "html_text_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `text`. This is the HTML representation of the text value of a custom field, corresponding to the `text_value` plain-text field. See [rich text](/docs/rich-text#reading-rich-text).",
                      "example": "<body>Some Value</body>",
                      "nullable": true,
                      "readOnly": true,
                      "type": "string"
                    },
                    "id_prefix": {
                      "description": "This field is the unique custom ID string for the custom field.",
                      "example": "ID",
                      "nullable": true,
                      "type": "string"
                    },
                    "input_restrictions": {
                      "example": [
                        "task"
                      ],
                      "items": {
                        "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                        "enum": [
                          "task",
                          "project",
                          "portfolio",
                          "goal"
                        ],
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "is_formula_field": {
                      "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                      "example": false,
                      "type": "boolean"
                    },
                    "is_global_to_workspace": {
                      "description": "This flag describes whether this custom field is available to every container in the workspace. Before project-specific custom fields, this field was always true.",
                      "example": true,
                      "readOnly": true,
                      "type": "boolean"
                    },
                    "is_lookup_field": {
                      "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                      "example": false,
                      "type": "boolean"
                    },
                    "is_value_read_only": {
                      "description": "*Conditional*. This flag describes whether a custom field is read only.",
                      "example": false,
                      "type": "boolean"
                    },
                    "multi_enum_values": {
                      "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                        "properties": {
                          "color": {
                            "description": "The color of the enum option. Defaults to `none`.",
                            "example": "blue",
                            "type": "string"
                          },
                          "enabled": {
                            "description": "Whether or not the enum option is a selectable value for the custom field.",
                            "example": true,
                            "type": "boolean"
                          },
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "The name of the enum option.",
                            "example": "Low",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object",
                        "x-docs-overrides": {
                          "properties.resource_type.example": "enum_option"
                        }
                      },
                      "type": "array"
                    },
                    "name": {
                      "description": "The name of the custom field.",
                      "example": "Status",
                      "type": "string"
                    },
                    "number_value": {
                      "description": "*Conditional*. This number is the value of a `number` custom field.",
                      "example": 5.2,
                      "nullable": true,
                      "type": "number"
                    },
                    "people_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `people`. This array of [compact user](/reference/users) objects reflects the values of a `people` custom field.",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                        "properties": {
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "*Read-only except when same user as requester*. The user's name.",
                            "example": "Greg Sanchez",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object",
                        "x-docs-overrides": {
                          "properties.resource_type.example": "user"
                        }
                      },
                      "type": "array"
                    },
                    "precision": {
                      "description": "Only relevant for custom fields of type `Number`. This field dictates the number of places after the decimal to round to, i.e. 0 is integer values, 1 rounds to the nearest tenth, and so on. Must be between 0 and 6, inclusive.\nFor percentage format, this may be unintuitive, as a value of 0.25 has a precision of 0, while a value of 0.251 has a precision of 1. This is due to 0.25 being displayed as 25%.\nThe identifier format will always have a precision of 0.",
                      "example": 2,
                      "type": "integer"
                    },
                    "privacy_setting": {
                      "description": "The privacy setting of the custom field. *Note: Administrators in your organization may restrict the values of `privacy_setting`.*",
                      "enum": [
                        "public_with_guests",
                        "public",
                        "private"
                      ],
                      "example": "public_with_guests",
                      "type": "string"
                    },
                    "reference_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of objects reflects the values of a `reference` custom field.",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.",
                        "properties": {
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "The name of the object.",
                            "example": "Bug Task",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "representation_type": {
                      "description": "This field tells the type of the custom field.",
                      "enum": [
                        "text",
                        "enum",
                        "multi_enum",
                        "number",
                        "date",
                        "people",
                        "formula",
                        "custom_id",
                        "reference"
                      ],
                      "example": "number",
                      "readOnly": true,
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The type of the custom field. Must be one of the given values.\n",
                      "enum": [
                        "text",
                        "enum",
                        "multi_enum",
                        "number",
                        "date",
                        "people",
                        "reference"
                      ],
                      "example": "text",
                      "readOnly": true,
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    },
                    "text_value": {
                      "description": "*Conditional*. This string is the value of a `text` custom field.",
                      "example": "Some Value",
                      "nullable": true,
                      "type": "string"
                    },
                    "type": {
                      "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                      "enum": [
                        "text",
                        "enum",
                        "multi_enum",
                        "number",
                        "date",
                        "people",
                        "reference"
                      ],
                      "readOnly": true,
                      "type": "string"
                    }
                  },
                  "readOnly": true,
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "custom_field"
                  }
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "is_important": {
                  "description": "`is_important` is used in the Asana web application to determine if this custom field is displayed in the list/grid view of a project or portfolio.",
                  "example": false,
                  "readOnly": true,
                  "type": "boolean"
                },
                "parent": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\nThe parent to which the custom field is applied. This can be a project or portfolio and indicates that the tasks or projects that the parent contains may be given custom field values for this custom field.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "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.",
                      "example": "Stuff to buy",
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                      "enum": [
                        "default_project",
                        "custom"
                      ],
                      "example": "default_project",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "readOnly": true,
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "project"
                  }
                },
                "project": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\n*Deprecated: new integrations should prefer the `parent` field.* The id of the project that this custom field settings refers to.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "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.",
                      "example": "Stuff to buy",
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                      "enum": [
                        "default_project",
                        "custom"
                      ],
                      "example": "default_project",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "readOnly": true,
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "project"
                  }
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "custom_field_setting"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "default_access_level": {
            "description": "The default access for users or teams who join or are added as members to the project.",
            "enum": [
              "admin",
              "editor",
              "commenter",
              "viewer"
            ],
            "example": "admin",
            "type": "string"
          },
          "default_view": {
            "description": "The default view (list, board, calendar, or timeline) of a project.",
            "enum": [
              "list",
              "board",
              "calendar",
              "timeline"
            ],
            "example": "calendar",
            "type": "string"
          },
          "due_date": {
            "description": "*Deprecated: new integrations should prefer the `due_on` field.*",
            "example": "2019-09-15",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "due_on": {
            "description": "The day on which this project is due. This takes a date with format YYYY-MM-DD.",
            "example": "2019-09-15",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_notes": {
            "description": "[Opt In](/docs/inputoutput-options). The notes of the project with formatting as HTML. See [rich text](/docs/rich-text).",
            "example": "<body>These are things we need to purchase.</body>",
            "type": "string"
          },
          "icon": {
            "description": "The icon for a project.",
            "enum": [
              "list",
              "board",
              "timeline",
              "calendar",
              "rocket",
              "people",
              "graph",
              "star",
              "bug",
              "light_bulb",
              "globe",
              "gear",
              "notebook",
              "computer",
              "check",
              "target",
              "html",
              "megaphone",
              "chat_bubbles",
              "briefcase",
              "page_layout",
              "mountain_flag",
              "puzzle",
              "presentation",
              "line_and_symbols",
              "speed_dial",
              "ribbon",
              "shoe",
              "shopping_basket",
              "map",
              "ticket",
              "coins"
            ],
            "example": "chat_bubbles",
            "nullable": true,
            "type": "string"
          },
          "members": {
            "description": "Array of users who are members of this project.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "*Read-only except when same user as requester*. The user's name.",
                  "example": "Greg Sanchez",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "user"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "minimum_access_level_for_customization": {
            "description": "The minimum access level needed for project members to modify this project's workflow and appearance.",
            "enum": [
              "admin",
              "editor"
            ],
            "example": "admin",
            "type": "string"
          },
          "minimum_access_level_for_sharing": {
            "description": "The minimum access level needed for project members to share the project and manage project memberships.",
            "enum": [
              "admin",
              "editor"
            ],
            "example": "admin",
            "type": "string"
          },
          "modified_at": {
            "description": "The time at which this project was last modified.\n*Note: This does not currently reflect any changes in associations such as tasks or comments that may have been added or removed from the project.*",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "name": {
            "description": "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.",
            "example": "Stuff to buy",
            "type": "string"
          },
          "notes": {
            "description": "Free-form textual information associated with the project (ie., its description).",
            "example": "These are things we need to purchase.",
            "type": "string"
          },
          "privacy_setting": {
            "description": "The privacy setting of the project. *Note: Administrators in your organization may restrict the values of `privacy_setting`.* The value `private_to_team` is deprecated. Use `POST /memberships` to share a project with a team after creation.",
            "enum": [
              "public_to_workspace",
              "private_to_team",
              "private"
            ],
            "example": "public_to_workspace",
            "type": "string"
          },
          "public": {
            "deprecated": true,
            "description": "*Deprecated:* new integrations use `privacy_setting` instead.",
            "example": false,
            "type": "boolean"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "enum": [
              "default_project",
              "custom"
            ],
            "example": "default_project",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_on": {
            "description": "The day on which work for this project begins, or null if the project has no start date. This takes a date with `YYYY-MM-DD` format. *Note: `due_on` or `due_at` must be present in the request when setting or unsetting the `start_on` parameter. Additionally, `start_on` and `due_on` cannot be the same date.*",
            "example": "2019-09-14",
            "format": "date",
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "project"
        }
      },
      "sdk__ProjectBriefBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *Project Brief* allows you to explain the what and why of the project to your team.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_text": {
            "description": "HTML formatted text for the project brief. See [rich text](/docs/rich-text).",
            "example": "<body>This is a <strong>project brief</strong>.</body>",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "title": {
            "description": "The title of the project brief.",
            "example": "Stuff to buy — Project Brief",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "project_brief"
        }
      },
      "sdk__ProjectBriefCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *Project Brief* allows you to explain the what and why of the project to your team.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "project_brief"
        }
      },
      "sdk__ProjectBriefRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *Project Brief* allows you to explain the what and why of the project to your team.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_text": {
            "description": "HTML formatted text for the project brief. See [rich text](/docs/rich-text).",
            "example": "<body>This is a <strong>project brief</strong>.</body>",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "text": {
            "description": "The plain text of the project brief. When writing to a project brief, you can specify either `html_text` (preferred) or `text`, but not both.",
            "example": "This is a project brief.",
            "type": "string"
          },
          "title": {
            "description": "The title of the project brief.",
            "example": "Stuff to buy — Project Brief",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "project_brief"
        }
      },
      "sdk__ProjectBriefResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *Project Brief* allows you to explain the what and why of the project to your team.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_text": {
            "description": "HTML formatted text for the project brief. See [rich text](/docs/rich-text).",
            "example": "<body>This is a <strong>project brief</strong>.</body>",
            "type": "string"
          },
          "permalink_url": {
            "description": "A url that points directly to the object within Asana.",
            "example": "https://app.asana.com/0/11111111/22222222",
            "readOnly": true,
            "type": "string"
          },
          "project": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\nThe project with which this project brief is associated.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "text": {
            "description": "[Opt In](/docs/inputoutput-options). The plain text of the project brief.",
            "example": "This is a project brief.",
            "type": "string"
          },
          "title": {
            "description": "The title of the project brief.",
            "example": "Stuff to buy — Project Brief",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "project_brief"
        }
      },
      "sdk__ProjectBriefResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__ProjectBriefResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__ProjectCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "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.",
            "example": "Stuff to buy",
            "type": "string"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "enum": [
              "default_project",
              "custom"
            ],
            "example": "default_project",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "project"
        }
      },
      "sdk__ProjectDuplicateRequest": {
        "properties": {
          "include": {
            "description": "A comma-separated list of elements to include when duplicating a project.\nSome elements are automatically included and cannot be excluded,\nwhile others are **optional** and must be explicitly specified in this field.\n\n**Auto-included fields (non-configurable)**\n- Tasks\n- [Project Views](https://asana.com/features/project-management/project-views)\n(i.e., tabs in a project such as List, Board, Dashboard, etc.)\n- [Rules](https://help.asana.com/s/article/rules)\n\n*Note: The Owner of the Rules copied to the new project is the user who performs the API call.\nIf the duplication is performed using a [Service Account](/docs/authentication#/service-account),\nnote that Service Accounts cannot access the UI to modify or pause Rules.\nTo prevent unwanted automation behavior, consider pausing Rules in the source project before duplication —\ntheir active/paused state is preserved in the new project.*\n\n**Optional fields (configurable)**\n- allocations\n- forms\n- members\n- notes\n- permissions\n- task_assignee\n- task_attachments\n- task_dates\n- task_dependencies\n- task_followers\n- task_notes\n- task_projects\n- task_subtasks\n- task_tags\n- task_templates\n- task_type_default",
            "example": [
              "allocations,forms,members,notes,permissions,task_assignee,task_attachments,task_dates,task_dependencies,task_followers,task_notes,task_projects,task_subtasks,task_tags,task_templates,task_type_default"
            ],
            "pattern": "([allocations|forms|members|notes|permissions|task_assignee|task_attachments|task_dates|task_dependencies|task_followers|task_notes|task_projects|task_subtasks|task_tags|task_templates|task_type_default])(,\\1)*",
            "type": "string"
          },
          "name": {
            "description": "The name of the new project.",
            "example": "New Project Name",
            "type": "string"
          },
          "schedule_dates": {
            "description": "A dictionary of options to auto-shift dates. `task_dates` must be included to use this option. Requires `should_skip_weekends` and either `start_on` or `due_on`, but not both.",
            "properties": {
              "due_on": {
                "description": "Sets the last due date in the duplicated project to the given date. The rest of the due dates will be offset by the same amount as the due dates in the original project.",
                "example": "2019-05-21",
                "type": "string"
              },
              "should_skip_weekends": {
                "description": "**Required**: Determines if the auto-shifted dates should skip weekends.",
                "example": true,
                "type": "boolean"
              },
              "start_on": {
                "description": "Sets the first start date in the duplicated project to the given date. The rest of the start dates will be offset by the same amount as the start dates in the original project.",
                "example": "2019-05-21",
                "type": "string"
              }
            },
            "type": "object"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "sdk__ProjectMembershipBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object describes a team or a user's membership to a project including their level of access (Admin, Editor, Commenter, or Viewer).",
        "properties": {
          "access_level": {
            "description": "Whether the member has admin, editor, commenter, or viewer access to the project.",
            "enum": [
              "admin",
              "editor",
              "commenter",
              "viewer"
            ],
            "example": "admin",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the member",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of the member (team or user)",
                "example": "user",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "member"
            }
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "project_membership"
        }
      },
      "sdk__ProjectMembershipCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object describes a team or a user's membership to a project including their level of access (Admin, Editor, Commenter, or Viewer).",
        "properties": {
          "access_level": {
            "description": "Whether the member has admin, editor, commenter, or viewer access to the project.",
            "enum": [
              "admin",
              "editor",
              "commenter",
              "viewer"
            ],
            "example": "admin",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the member",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of the member (team or user)",
                "example": "user",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "member"
            }
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "project_membership"
        }
      },
      "sdk__ProjectMembershipCompactArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__ProjectMembershipCompact"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__ProjectMembershipCompactResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object describes a team or a user's membership to a project including their level of access (Admin, Editor, Commenter, or Viewer).",
        "properties": {
          "access_level": {
            "description": "Whether the member has admin, editor, commenter, or viewer access to the project.",
            "enum": [
              "admin",
              "editor",
              "commenter",
              "viewer"
            ],
            "example": "admin",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the member",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of the member (team or user)",
                "example": "user",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "member"
            }
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          "resource_subtype": {
            "description": "Type of the membership.",
            "example": "project_membership",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "membership",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "project_membership"
        }
      },
      "sdk__ProjectMembershipNormalResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object describes a team or a user's membership to a project including their level of access (Admin, Editor, Commenter, or Viewer).",
        "properties": {
          "access_level": {
            "description": "Whether the member has admin, editor, commenter, or viewer access to the project.",
            "enum": [
              "admin",
              "editor",
              "commenter",
              "viewer"
            ],
            "example": "admin",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the member",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of the member (team or user)",
                "example": "user",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "member"
            }
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          "project": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "project_membership",
            "type": "string"
          },
          "user": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "write_access": {
            "description": "Whether the member has full access or comment-only access to the project.",
            "enum": [
              "full_write",
              "comment_only"
            ],
            "example": "full_write",
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "project_membership"
        }
      },
      "sdk__ProjectMembershipNormalResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__ProjectMembershipNormalResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__ProjectPortfolioSettingCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA project portfolio setting represents the relationship between a project and a portfolio, including configuration such as access control inheritance.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "is_access_control_inherited": {
            "description": "When true, the portfolio members gain access to the project.",
            "example": true,
            "type": "boolean"
          },
          "portfolio": {
            "allOf": [
              {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *portfolio* gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent [project status](/reference/project-statuses) update.\nPortfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the portfolio.",
                    "example": "Bug Portfolio",
                    "type": "string"
                  },
                  "resource_subtype": {
                    "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                    "enum": [
                      "default_portfolio",
                      "custom"
                    ],
                    "example": "default_portfolio",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "portfolio"
                }
              },
              {
                "type": "object"
              }
            ],
            "description": "The portfolio associated with this setting."
          },
          "project": {
            "allOf": [
              {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "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.",
                    "example": "Stuff to buy",
                    "type": "string"
                  },
                  "resource_subtype": {
                    "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                    "enum": [
                      "default_project",
                      "custom"
                    ],
                    "example": "default_project",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "project"
                }
              },
              {
                "type": "object"
              }
            ],
            "description": "The project associated with this setting."
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "project_portfolio_setting"
        }
      },
      "sdk__ProjectPortfolioSettingResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA project portfolio setting represents the relationship between a project and a portfolio, including configuration such as access control inheritance.",
        "properties": {
          "created_at": {
            "description": "The time at which this project portfolio setting was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "is_access_control_inherited": {
            "description": "When true, the portfolio members gain access to the project.",
            "example": true,
            "type": "boolean"
          },
          "portfolio": {
            "allOf": [
              {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *portfolio* gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent [project status](/reference/project-statuses) update.\nPortfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the portfolio.",
                    "example": "Bug Portfolio",
                    "type": "string"
                  },
                  "resource_subtype": {
                    "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                    "enum": [
                      "default_portfolio",
                      "custom"
                    ],
                    "example": "default_portfolio",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "portfolio"
                }
              },
              {
                "type": "object"
              }
            ],
            "description": "The portfolio associated with this setting."
          },
          "project": {
            "allOf": [
              {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "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.",
                    "example": "Stuff to buy",
                    "type": "string"
                  },
                  "resource_subtype": {
                    "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                    "enum": [
                      "default_project",
                      "custom"
                    ],
                    "example": "default_project",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "project"
                }
              },
              {
                "type": "object"
              }
            ],
            "description": "The project associated with this setting."
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "project_portfolio_setting"
        }
      },
      "sdk__ProjectPortfolioSettingResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__ProjectPortfolioSettingResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__ProjectPortfolioSettingResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__ProjectPortfolioSettingResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__ProjectPortfolioSettingUpdateRequest": {
        "properties": {
          "is_access_control_inherited": {
            "description": "When true, the portfolio members gain access to the project.",
            "example": true,
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "sdk__ProjectRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
        "properties": {
          "archived": {
            "description": "True if the project is archived, false if not. Archived projects do not show in the UI by default and may be treated differently for queries.",
            "example": false,
            "type": "boolean"
          },
          "color": {
            "description": "Color of the project.",
            "enum": [
              "dark-pink",
              "dark-green",
              "dark-blue",
              "dark-red",
              "dark-teal",
              "dark-brown",
              "dark-orange",
              "dark-purple",
              "dark-warm-gray",
              "light-pink",
              "light-green",
              "light-blue",
              "light-red",
              "light-teal",
              "light-brown",
              "light-orange",
              "light-purple",
              "light-warm-gray",
              "none",
              null
            ],
            "example": "light-green",
            "nullable": true,
            "type": "string"
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "current_status": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\n*Deprecated: new integrations should prefer the `status_update` resource.*\nA *project status* is an update on the progress of a particular project, and is sent out to all project followers when created. These updates include both text describing the update and a color code intended to represent the overall state of the project: \"green\" for projects that are on track, \"yellow\" for projects at risk, and \"red\" for projects that are behind.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\n*Deprecated: new integrations should prefer the `status_update` resource.*\nA *project status* is an update on the progress of a particular project, and is sent out to all project followers when created. These updates include both text describing the update and a color code intended to represent the overall state of the project: \"green\" for projects that are on track, \"yellow\" for projects at risk, and \"red\" for projects that are behind.\n*Deprecated: new integrations should prefer the `current_status_update` resource.*",
            "nullable": true,
            "properties": {
              "author": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "color": {
                "description": "The color associated with the status update.",
                "enum": [
                  "green",
                  "yellow",
                  "red",
                  "blue",
                  "complete"
                ],
                "type": "string"
              },
              "created_at": {
                "description": "The time at which this resource was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "created_by": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "html_text": {
                "description": "[Opt In](/docs/inputoutput-options). The text content of the status update with formatting as HTML. See [rich text](/docs/rich-text).",
                "example": "<body>The project <strong>is</strong> moving forward according to plan...</body>",
                "type": "string"
              },
              "modified_at": {
                "description": "The time at which this project status was last modified.\n*Note: This does not currently reflect any changes in associations such as comments that may have been added or removed from the project status.*",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              },
              "text": {
                "description": "The text content of the status update.",
                "example": "The project is moving forward according to plan...",
                "type": "string"
              },
              "title": {
                "description": "The title of the project status update.",
                "example": "Status Update - Jun 15",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project_status"
            }
          },
          "current_status_update": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *status update* is an update on the progress of a particular project, portfolio, or goal, and is sent out to all of its parent's followers when created. These updates include both text describing the update and a `status_type` intended to represent the overall state of the object.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *status update* is an update on the progress of a particular project, portfolio, or goal, and is sent out to all of its parent's followers when created. These updates include both text describing the update and a `status_type` intended to represent the overall state of the object.\nThe latest `status_update` posted to this project.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe `resource_subtype`s for `status` objects represent the type of their parent.",
                "enum": [
                  "project_status_update",
                  "portfolio_status_update",
                  "goal_status_update"
                ],
                "example": "project_status_update",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              },
              "title": {
                "description": "The title of the status update.",
                "example": "Status Update - Jun 15",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "status_update"
            }
          },
          "custom_field_settings": {
            "description": "Array of custom field definitions that are enabled for the project. These represent which custom fields are available to be used on tasks within the project, but do not include any values.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields Settings objects represent the many-to-many join of the Custom Field and Project as well as stores information that is relevant to that particular pairing.",
              "properties": {
                "custom_field": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.\nThe custom field that is applied to the `parent`.",
                  "properties": {
                    "asana_created_field": {
                      "description": "*Conditional*. A unique identifier to associate this field with the template source of truth.",
                      "enum": [
                        "a_v_requirements",
                        "account_name",
                        "actionable",
                        "align_shipping_link",
                        "align_status",
                        "allotted_time",
                        "appointment",
                        "approval_stage",
                        "approved",
                        "article_series",
                        "board_committee",
                        "browser",
                        "campaign_audience",
                        "campaign_project_status",
                        "campaign_regions",
                        "channel_primary",
                        "client_topic_type",
                        "complete_by",
                        "contact",
                        "contact_email_address",
                        "content_channels",
                        "content_channels_needed",
                        "content_stage",
                        "content_type",
                        "contract",
                        "contract_status",
                        "cost",
                        "creation_stage",
                        "creative_channel",
                        "creative_needed",
                        "creative_needs",
                        "data_sensitivity",
                        "deal_size",
                        "delivery_appt",
                        "delivery_appt_date",
                        "department",
                        "department_responsible",
                        "design_request_needed",
                        "design_request_type",
                        "discussion_category",
                        "do_this_task",
                        "editorial_content_status",
                        "editorial_content_tag",
                        "editorial_content_type",
                        "effort",
                        "effort_level",
                        "est_completion_date",
                        "estimated_time",
                        "estimated_value",
                        "expected_cost",
                        "external_steps_needed",
                        "favorite_idea",
                        "feedback_type",
                        "financial",
                        "funding_amount",
                        "grant_application_process",
                        "hiring_candidate_status",
                        "idea_status",
                        "ids_link",
                        "ids_patient_link",
                        "implementation_stage",
                        "insurance",
                        "interview_area",
                        "interview_question_score",
                        "itero_scan_link",
                        "job_s_applied_to",
                        "lab",
                        "launch_status",
                        "lead_status",
                        "localization_language",
                        "localization_market_team",
                        "localization_status",
                        "meeting_minutes",
                        "meeting_needed",
                        "minutes",
                        "mrr",
                        "must_localize",
                        "name_of_foundation",
                        "need_to_follow_up",
                        "next_appointment",
                        "next_steps_sales",
                        "num_people",
                        "number_of_user_reports",
                        "office_location",
                        "onboarding_activity",
                        "owner",
                        "participants_needed",
                        "patient_date_of_birth",
                        "patient_email",
                        "patient_phone",
                        "patient_status",
                        "phone_number",
                        "planning_category",
                        "point_of_contact",
                        "position",
                        "post_format",
                        "prescription",
                        "priority",
                        "priority_level",
                        "product",
                        "product_stage",
                        "progress",
                        "project_size",
                        "project_status",
                        "proposed_budget",
                        "publish_status",
                        "reason_for_scan",
                        "referral",
                        "request_type",
                        "research_status",
                        "responsible_department",
                        "responsible_team",
                        "risk_assessment_status",
                        "room_name",
                        "sales_counterpart",
                        "sentiment",
                        "shipping_link",
                        "social_channels",
                        "stage",
                        "status",
                        "status_design",
                        "status_of_initiative",
                        "system_setup",
                        "task_progress",
                        "team",
                        "team_marketing",
                        "team_responsible",
                        "time_it_takes_to_complete_tasks",
                        "timeframe",
                        "treatment_type",
                        "type_work_requests_it",
                        "use_agency",
                        "user_name",
                        "vendor_category",
                        "vendor_type",
                        "word_count",
                        null
                      ],
                      "example": "priority",
                      "nullable": true,
                      "readOnly": true,
                      "type": "string"
                    },
                    "created_by": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                      "nullable": true,
                      "properties": {
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "*Read-only except when same user as requester*. The user's name.",
                          "example": "Greg Sanchez",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "user"
                      }
                    },
                    "currency_code": {
                      "description": "ISO 4217 currency code to format this custom field. This will be null if the `format` is not `currency`.",
                      "example": "EUR",
                      "nullable": true,
                      "type": "string"
                    },
                    "custom_label": {
                      "description": "This is the string that appears next to the custom field value. This will be null if the `format` is not `custom`.",
                      "example": "gold pieces",
                      "nullable": true,
                      "type": "string"
                    },
                    "custom_label_position": {
                      "description": "Only relevant for custom fields with `custom` format. This depicts where to place the custom label. This will be null if the `format` is not `custom`.",
                      "enum": [
                        "prefix",
                        "suffix",
                        null
                      ],
                      "example": "suffix",
                      "nullable": true,
                      "type": "string"
                    },
                    "date_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                      "nullable": true,
                      "properties": {
                        "date": {
                          "description": "A string representing the date in YYYY-MM-DD format.",
                          "example": "2024-08-23",
                          "type": "string"
                        },
                        "date_time": {
                          "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                          "example": "2024-08-23T22:00:00.000Z",
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    "default_access_level": {
                      "description": "The default access level when inviting new members to the custom field. This isn't applied when the `privacy_setting` is `private`, or the user is a guest. For local fields in a project or portfolio, the user must additionally have permission to modify the container itself.",
                      "enum": [
                        "admin",
                        "editor",
                        "user"
                      ],
                      "example": "user",
                      "type": "string"
                    },
                    "description": {
                      "description": "[Opt In](/docs/inputoutput-options). The description of the custom field.",
                      "example": "Development team priority",
                      "type": "string"
                    },
                    "display_value": {
                      "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                      "example": "blue",
                      "nullable": true,
                      "readOnly": true,
                      "type": "string"
                    },
                    "enabled": {
                      "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                      "example": true,
                      "readOnly": true,
                      "type": "boolean"
                    },
                    "enum_options": {
                      "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                        "properties": {
                          "color": {
                            "description": "The color of the enum option. Defaults to `none`.",
                            "example": "blue",
                            "type": "string"
                          },
                          "enabled": {
                            "description": "Whether or not the enum option is a selectable value for the custom field.",
                            "example": true,
                            "type": "boolean"
                          },
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "The name of the enum option.",
                            "example": "Low",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object",
                        "x-docs-overrides": {
                          "properties.resource_type.example": "enum_option"
                        }
                      },
                      "type": "array"
                    },
                    "enum_value": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                      "nullable": true,
                      "properties": {
                        "color": {
                          "description": "The color of the enum option. Defaults to `none`.",
                          "example": "blue",
                          "type": "string"
                        },
                        "enabled": {
                          "description": "Whether or not the enum option is a selectable value for the custom field.",
                          "example": true,
                          "type": "boolean"
                        },
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "The name of the enum option.",
                          "example": "Low",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "enum_option"
                      }
                    },
                    "format": {
                      "description": "The format of this custom field.",
                      "enum": [
                        "currency",
                        "identifier",
                        "percentage",
                        "custom",
                        "duration",
                        "none"
                      ],
                      "example": "custom",
                      "type": "string"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "has_notifications_enabled": {
                      "description": "*Conditional*. This flag describes whether a follower of a task with this field should receive inbox notifications from changes to this field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "html_text_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `text`. This is the HTML representation of the text value of a custom field, corresponding to the `text_value` plain-text field. See [rich text](/docs/rich-text#reading-rich-text).",
                      "example": "<body>Some Value</body>",
                      "nullable": true,
                      "readOnly": true,
                      "type": "string"
                    },
                    "id_prefix": {
                      "description": "This field is the unique custom ID string for the custom field.",
                      "example": "ID",
                      "nullable": true,
                      "type": "string"
                    },
                    "input_restrictions": {
                      "example": [
                        "task"
                      ],
                      "items": {
                        "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                        "enum": [
                          "task",
                          "project",
                          "portfolio",
                          "goal"
                        ],
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "is_formula_field": {
                      "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                      "example": false,
                      "type": "boolean"
                    },
                    "is_global_to_workspace": {
                      "description": "This flag describes whether this custom field is available to every container in the workspace. Before project-specific custom fields, this field was always true.",
                      "example": true,
                      "readOnly": true,
                      "type": "boolean"
                    },
                    "is_lookup_field": {
                      "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                      "example": false,
                      "type": "boolean"
                    },
                    "is_value_read_only": {
                      "description": "*Conditional*. This flag describes whether a custom field is read only.",
                      "example": false,
                      "type": "boolean"
                    },
                    "multi_enum_values": {
                      "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                        "properties": {
                          "color": {
                            "description": "The color of the enum option. Defaults to `none`.",
                            "example": "blue",
                            "type": "string"
                          },
                          "enabled": {
                            "description": "Whether or not the enum option is a selectable value for the custom field.",
                            "example": true,
                            "type": "boolean"
                          },
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "The name of the enum option.",
                            "example": "Low",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object",
                        "x-docs-overrides": {
                          "properties.resource_type.example": "enum_option"
                        }
                      },
                      "type": "array"
                    },
                    "name": {
                      "description": "The name of the custom field.",
                      "example": "Status",
                      "type": "string"
                    },
                    "number_value": {
                      "description": "*Conditional*. This number is the value of a `number` custom field.",
                      "example": 5.2,
                      "nullable": true,
                      "type": "number"
                    },
                    "people_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `people`. This array of [compact user](/reference/users) objects reflects the values of a `people` custom field.",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                        "properties": {
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "*Read-only except when same user as requester*. The user's name.",
                            "example": "Greg Sanchez",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object",
                        "x-docs-overrides": {
                          "properties.resource_type.example": "user"
                        }
                      },
                      "type": "array"
                    },
                    "precision": {
                      "description": "Only relevant for custom fields of type `Number`. This field dictates the number of places after the decimal to round to, i.e. 0 is integer values, 1 rounds to the nearest tenth, and so on. Must be between 0 and 6, inclusive.\nFor percentage format, this may be unintuitive, as a value of 0.25 has a precision of 0, while a value of 0.251 has a precision of 1. This is due to 0.25 being displayed as 25%.\nThe identifier format will always have a precision of 0.",
                      "example": 2,
                      "type": "integer"
                    },
                    "privacy_setting": {
                      "description": "The privacy setting of the custom field. *Note: Administrators in your organization may restrict the values of `privacy_setting`.*",
                      "enum": [
                        "public_with_guests",
                        "public",
                        "private"
                      ],
                      "example": "public_with_guests",
                      "type": "string"
                    },
                    "reference_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of objects reflects the values of a `reference` custom field.",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.",
                        "properties": {
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "The name of the object.",
                            "example": "Bug Task",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "representation_type": {
                      "description": "This field tells the type of the custom field.",
                      "enum": [
                        "text",
                        "enum",
                        "multi_enum",
                        "number",
                        "date",
                        "people",
                        "formula",
                        "custom_id",
                        "reference"
                      ],
                      "example": "number",
                      "readOnly": true,
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The type of the custom field. Must be one of the given values.\n",
                      "enum": [
                        "text",
                        "enum",
                        "multi_enum",
                        "number",
                        "date",
                        "people",
                        "reference"
                      ],
                      "example": "text",
                      "readOnly": true,
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    },
                    "text_value": {
                      "description": "*Conditional*. This string is the value of a `text` custom field.",
                      "example": "Some Value",
                      "nullable": true,
                      "type": "string"
                    },
                    "type": {
                      "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                      "enum": [
                        "text",
                        "enum",
                        "multi_enum",
                        "number",
                        "date",
                        "people",
                        "reference"
                      ],
                      "readOnly": true,
                      "type": "string"
                    }
                  },
                  "readOnly": true,
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "custom_field"
                  }
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "is_important": {
                  "description": "`is_important` is used in the Asana web application to determine if this custom field is displayed in the list/grid view of a project or portfolio.",
                  "example": false,
                  "readOnly": true,
                  "type": "boolean"
                },
                "parent": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\nThe parent to which the custom field is applied. This can be a project or portfolio and indicates that the tasks or projects that the parent contains may be given custom field values for this custom field.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "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.",
                      "example": "Stuff to buy",
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                      "enum": [
                        "default_project",
                        "custom"
                      ],
                      "example": "default_project",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "readOnly": true,
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "project"
                  }
                },
                "project": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\n*Deprecated: new integrations should prefer the `parent` field.* The id of the project that this custom field settings refers to.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "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.",
                      "example": "Stuff to buy",
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                      "enum": [
                        "default_project",
                        "custom"
                      ],
                      "example": "default_project",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "readOnly": true,
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "project"
                  }
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "custom_field_setting"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "custom_fields": {
            "additionalProperties": {
              "description": "\"{custom_field_gid}\" => Value (can be text, a number, etc.). For date, use format \"YYYY-MM-DD\" (e.g., 2019-09-15). For date-time, use ISO 8601 date string in UTC (e.g., 2019-09-15T02:06:58.147Z).",
              "type": "string"
            },
            "description": "An object where each key is the GID of a custom field and its corresponding value is either an enum GID, string, number, or object (depending on the custom field type). See the [custom fields guide](/docs/custom-fields-guide) for details on creating and updating custom field values.",
            "example": {
              "4578152156": "Not Started",
              "5678904321": "On Hold"
            },
            "type": "object"
          },
          "custom_type": {
            "description": "*Conditional:* You can only set custom_type if project `resource_subtype` is `custom`. GID or globally-unique identifier of a project's custom type. The type must be valid for projects, and some Asana-created custom types cannot be assigned via the API; attempting either returns an error explaining which condition failed.",
            "example": "12345",
            "nullable": true,
            "readOnly": false,
            "type": "string",
            "x-env-variable": true
          },
          "default_access_level": {
            "description": "The default access for users or teams who join or are added as members to the project.",
            "enum": [
              "admin",
              "editor",
              "commenter",
              "viewer"
            ],
            "example": "admin",
            "type": "string"
          },
          "default_view": {
            "description": "The default view (list, board, calendar, or timeline) of a project.",
            "enum": [
              "list",
              "board",
              "calendar",
              "timeline"
            ],
            "example": "calendar",
            "type": "string"
          },
          "due_date": {
            "description": "*Deprecated: new integrations should prefer the `due_on` field.*",
            "example": "2019-09-15",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "due_on": {
            "description": "The day on which this project is due. This takes a date with format YYYY-MM-DD.",
            "example": "2019-09-15",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "followers": {
            "description": "*Create-only*. Comma separated string of users. Followers are a subset of members who have opted in to receive \"tasks added\" notifications for a project.",
            "example": "12345,23456",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_custom_fields": {
            "additionalProperties": {
              "description": "\"{custom_field_gid}\" => HTML string (e.g., \"<body>Text content</body>\")",
              "type": "string"
            },
            "description": "An object where each key is the GID of a text custom field and the corresponding value is a rich text HTML string. Only text-type custom fields support this parameter. Values must be wrapped in <body></body> tags. See the [custom fields guide](/docs/custom-fields-guide) and [rich text](/docs/rich-text) for details on supported formatting.",
            "example": {
              "4578152156": "<body><code>Code block</code></body>",
              "5678904321": "<body><strong>Bold text</strong></body>"
            },
            "type": "object"
          },
          "html_notes": {
            "description": "[Opt In](/docs/inputoutput-options). The notes of the project with formatting as HTML. See [rich text](/docs/rich-text).",
            "example": "<body>These are things we need to purchase.</body>",
            "type": "string"
          },
          "icon": {
            "description": "The icon for a project.",
            "enum": [
              "list",
              "board",
              "timeline",
              "calendar",
              "rocket",
              "people",
              "graph",
              "star",
              "bug",
              "light_bulb",
              "globe",
              "gear",
              "notebook",
              "computer",
              "check",
              "target",
              "html",
              "megaphone",
              "chat_bubbles",
              "briefcase",
              "page_layout",
              "mountain_flag",
              "puzzle",
              "presentation",
              "line_and_symbols",
              "speed_dial",
              "ribbon",
              "shoe",
              "shopping_basket",
              "map",
              "ticket",
              "coins"
            ],
            "example": "chat_bubbles",
            "nullable": true,
            "type": "string"
          },
          "members": {
            "description": "Array of users who are members of this project.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "*Read-only except when same user as requester*. The user's name.",
                  "example": "Greg Sanchez",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "user"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "minimum_access_level_for_customization": {
            "description": "The minimum access level needed for project members to modify this project's workflow and appearance.",
            "enum": [
              "admin",
              "editor"
            ],
            "example": "admin",
            "type": "string"
          },
          "minimum_access_level_for_sharing": {
            "description": "The minimum access level needed for project members to share the project and manage project memberships.",
            "enum": [
              "admin",
              "editor"
            ],
            "example": "admin",
            "type": "string"
          },
          "modified_at": {
            "description": "The time at which this project was last modified.\n*Note: This does not currently reflect any changes in associations such as tasks or comments that may have been added or removed from the project.*",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "name": {
            "description": "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.",
            "example": "Stuff to buy",
            "type": "string"
          },
          "notes": {
            "description": "Free-form textual information associated with the project (ie., its description).",
            "example": "These are things we need to purchase.",
            "type": "string"
          },
          "owner": {
            "description": "The current owner of the project, may be null.",
            "example": "12345",
            "nullable": true,
            "type": "string"
          },
          "privacy_setting": {
            "description": "The privacy setting of the project. *Note: Administrators in your organization may restrict the values of `privacy_setting`.* The value `private_to_team` is deprecated. Use `POST /memberships` to share a project with a team after creation.",
            "enum": [
              "public_to_workspace",
              "private_to_team",
              "private"
            ],
            "example": "public_to_workspace",
            "type": "string"
          },
          "public": {
            "deprecated": true,
            "description": "*Deprecated:* new integrations use `privacy_setting` instead.",
            "example": false,
            "type": "boolean"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "enum": [
              "default_project",
              "custom"
            ],
            "example": "default_project",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_on": {
            "description": "The day on which work for this project begins, or null if the project has no start date. This takes a date with `YYYY-MM-DD` format. *Note: `due_on` or `due_at` must be present in the request when setting or unsetting the `start_on` parameter. Additionally, `start_on` and `due_on` cannot be the same date.*",
            "example": "2019-09-14",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "team": {
            "deprecated": true,
            "description": "*Deprecated:* The team to share this project with is deprecated. Use `POST /memberships` with `{ parent: project, member: team }` to share a project with a team after creation.",
            "example": "12345",
            "type": "string"
          },
          "workspace": {
            "description": "The `gid` of a workspace.",
            "example": "12345",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "project"
        }
      },
      "sdk__ProjectResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
        "properties": {
          "archived": {
            "description": "True if the project is archived, false if not. Archived projects do not show in the UI by default and may be treated differently for queries.",
            "example": false,
            "type": "boolean"
          },
          "color": {
            "description": "Color of the project.",
            "enum": [
              "dark-pink",
              "dark-green",
              "dark-blue",
              "dark-red",
              "dark-teal",
              "dark-brown",
              "dark-orange",
              "dark-purple",
              "dark-warm-gray",
              "light-pink",
              "light-green",
              "light-blue",
              "light-red",
              "light-teal",
              "light-brown",
              "light-orange",
              "light-purple",
              "light-warm-gray",
              "none",
              null
            ],
            "example": "light-green",
            "nullable": true,
            "type": "string"
          },
          "completed": {
            "description": "True if the project is currently marked complete, false if not.",
            "example": false,
            "readOnly": true,
            "type": "boolean"
          },
          "completed_at": {
            "description": "The time at which this project was completed, or null if the project is not completed.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "completed_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.\nThe user that marked this project complete, or null if the project is not completed.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "created_from_template": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project template* is an object that allows new projects to be created with a predefined setup, which may include tasks, sections, Rules, etc. It simplifies the process of running a workflow that involves a similar set of work every time.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project template* is an object that allows new projects to be created with a predefined setup, which may include tasks, sections, Rules, etc. It simplifies the process of running a workflow that involves a similar set of work every time.\n[Opt In](/docs/inputoutput-options). The project template from which this project was created. If the project was not created from a template, this field will be null.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "Name of the project template.",
                "example": "Packing list",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project_template"
            }
          },
          "current_status": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\n*Deprecated: new integrations should prefer the `status_update` resource.*\nA *project status* is an update on the progress of a particular project, and is sent out to all project followers when created. These updates include both text describing the update and a color code intended to represent the overall state of the project: \"green\" for projects that are on track, \"yellow\" for projects at risk, and \"red\" for projects that are behind.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\n*Deprecated: new integrations should prefer the `status_update` resource.*\nA *project status* is an update on the progress of a particular project, and is sent out to all project followers when created. These updates include both text describing the update and a color code intended to represent the overall state of the project: \"green\" for projects that are on track, \"yellow\" for projects at risk, and \"red\" for projects that are behind.\n*Deprecated: new integrations should prefer the `current_status_update` resource.*",
            "nullable": true,
            "properties": {
              "author": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "color": {
                "description": "The color associated with the status update.",
                "enum": [
                  "green",
                  "yellow",
                  "red",
                  "blue",
                  "complete"
                ],
                "type": "string"
              },
              "created_at": {
                "description": "The time at which this resource was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "created_by": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "html_text": {
                "description": "[Opt In](/docs/inputoutput-options). The text content of the status update with formatting as HTML. See [rich text](/docs/rich-text).",
                "example": "<body>The project <strong>is</strong> moving forward according to plan...</body>",
                "type": "string"
              },
              "modified_at": {
                "description": "The time at which this project status was last modified.\n*Note: This does not currently reflect any changes in associations such as comments that may have been added or removed from the project status.*",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              },
              "text": {
                "description": "The text content of the status update.",
                "example": "The project is moving forward according to plan...",
                "type": "string"
              },
              "title": {
                "description": "The title of the project status update.",
                "example": "Status Update - Jun 15",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project_status"
            }
          },
          "current_status_update": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *status update* is an update on the progress of a particular project, portfolio, or goal, and is sent out to all of its parent's followers when created. These updates include both text describing the update and a `status_type` intended to represent the overall state of the object.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *status update* is an update on the progress of a particular project, portfolio, or goal, and is sent out to all of its parent's followers when created. These updates include both text describing the update and a `status_type` intended to represent the overall state of the object.\nThe latest `status_update` posted to this project.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe `resource_subtype`s for `status` objects represent the type of their parent.",
                "enum": [
                  "project_status_update",
                  "portfolio_status_update",
                  "goal_status_update"
                ],
                "example": "project_status_update",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              },
              "title": {
                "description": "The title of the status update.",
                "example": "Status Update - Jun 15",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "status_update"
            }
          },
          "custom_field_settings": {
            "description": "Array of custom field definitions that are enabled for the project. These represent which custom fields are available to be used on tasks within the project, but do not include any values.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields Settings objects represent the many-to-many join of the Custom Field and Project as well as stores information that is relevant to that particular pairing.",
              "properties": {
                "custom_field": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.\nThe custom field that is applied to the `parent`.",
                  "properties": {
                    "asana_created_field": {
                      "description": "*Conditional*. A unique identifier to associate this field with the template source of truth.",
                      "enum": [
                        "a_v_requirements",
                        "account_name",
                        "actionable",
                        "align_shipping_link",
                        "align_status",
                        "allotted_time",
                        "appointment",
                        "approval_stage",
                        "approved",
                        "article_series",
                        "board_committee",
                        "browser",
                        "campaign_audience",
                        "campaign_project_status",
                        "campaign_regions",
                        "channel_primary",
                        "client_topic_type",
                        "complete_by",
                        "contact",
                        "contact_email_address",
                        "content_channels",
                        "content_channels_needed",
                        "content_stage",
                        "content_type",
                        "contract",
                        "contract_status",
                        "cost",
                        "creation_stage",
                        "creative_channel",
                        "creative_needed",
                        "creative_needs",
                        "data_sensitivity",
                        "deal_size",
                        "delivery_appt",
                        "delivery_appt_date",
                        "department",
                        "department_responsible",
                        "design_request_needed",
                        "design_request_type",
                        "discussion_category",
                        "do_this_task",
                        "editorial_content_status",
                        "editorial_content_tag",
                        "editorial_content_type",
                        "effort",
                        "effort_level",
                        "est_completion_date",
                        "estimated_time",
                        "estimated_value",
                        "expected_cost",
                        "external_steps_needed",
                        "favorite_idea",
                        "feedback_type",
                        "financial",
                        "funding_amount",
                        "grant_application_process",
                        "hiring_candidate_status",
                        "idea_status",
                        "ids_link",
                        "ids_patient_link",
                        "implementation_stage",
                        "insurance",
                        "interview_area",
                        "interview_question_score",
                        "itero_scan_link",
                        "job_s_applied_to",
                        "lab",
                        "launch_status",
                        "lead_status",
                        "localization_language",
                        "localization_market_team",
                        "localization_status",
                        "meeting_minutes",
                        "meeting_needed",
                        "minutes",
                        "mrr",
                        "must_localize",
                        "name_of_foundation",
                        "need_to_follow_up",
                        "next_appointment",
                        "next_steps_sales",
                        "num_people",
                        "number_of_user_reports",
                        "office_location",
                        "onboarding_activity",
                        "owner",
                        "participants_needed",
                        "patient_date_of_birth",
                        "patient_email",
                        "patient_phone",
                        "patient_status",
                        "phone_number",
                        "planning_category",
                        "point_of_contact",
                        "position",
                        "post_format",
                        "prescription",
                        "priority",
                        "priority_level",
                        "product",
                        "product_stage",
                        "progress",
                        "project_size",
                        "project_status",
                        "proposed_budget",
                        "publish_status",
                        "reason_for_scan",
                        "referral",
                        "request_type",
                        "research_status",
                        "responsible_department",
                        "responsible_team",
                        "risk_assessment_status",
                        "room_name",
                        "sales_counterpart",
                        "sentiment",
                        "shipping_link",
                        "social_channels",
                        "stage",
                        "status",
                        "status_design",
                        "status_of_initiative",
                        "system_setup",
                        "task_progress",
                        "team",
                        "team_marketing",
                        "team_responsible",
                        "time_it_takes_to_complete_tasks",
                        "timeframe",
                        "treatment_type",
                        "type_work_requests_it",
                        "use_agency",
                        "user_name",
                        "vendor_category",
                        "vendor_type",
                        "word_count",
                        null
                      ],
                      "example": "priority",
                      "nullable": true,
                      "readOnly": true,
                      "type": "string"
                    },
                    "created_by": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                      "nullable": true,
                      "properties": {
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "*Read-only except when same user as requester*. The user's name.",
                          "example": "Greg Sanchez",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "user"
                      }
                    },
                    "currency_code": {
                      "description": "ISO 4217 currency code to format this custom field. This will be null if the `format` is not `currency`.",
                      "example": "EUR",
                      "nullable": true,
                      "type": "string"
                    },
                    "custom_label": {
                      "description": "This is the string that appears next to the custom field value. This will be null if the `format` is not `custom`.",
                      "example": "gold pieces",
                      "nullable": true,
                      "type": "string"
                    },
                    "custom_label_position": {
                      "description": "Only relevant for custom fields with `custom` format. This depicts where to place the custom label. This will be null if the `format` is not `custom`.",
                      "enum": [
                        "prefix",
                        "suffix",
                        null
                      ],
                      "example": "suffix",
                      "nullable": true,
                      "type": "string"
                    },
                    "date_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                      "nullable": true,
                      "properties": {
                        "date": {
                          "description": "A string representing the date in YYYY-MM-DD format.",
                          "example": "2024-08-23",
                          "type": "string"
                        },
                        "date_time": {
                          "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                          "example": "2024-08-23T22:00:00.000Z",
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    "default_access_level": {
                      "description": "The default access level when inviting new members to the custom field. This isn't applied when the `privacy_setting` is `private`, or the user is a guest. For local fields in a project or portfolio, the user must additionally have permission to modify the container itself.",
                      "enum": [
                        "admin",
                        "editor",
                        "user"
                      ],
                      "example": "user",
                      "type": "string"
                    },
                    "description": {
                      "description": "[Opt In](/docs/inputoutput-options). The description of the custom field.",
                      "example": "Development team priority",
                      "type": "string"
                    },
                    "display_value": {
                      "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                      "example": "blue",
                      "nullable": true,
                      "readOnly": true,
                      "type": "string"
                    },
                    "enabled": {
                      "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                      "example": true,
                      "readOnly": true,
                      "type": "boolean"
                    },
                    "enum_options": {
                      "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                        "properties": {
                          "color": {
                            "description": "The color of the enum option. Defaults to `none`.",
                            "example": "blue",
                            "type": "string"
                          },
                          "enabled": {
                            "description": "Whether or not the enum option is a selectable value for the custom field.",
                            "example": true,
                            "type": "boolean"
                          },
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "The name of the enum option.",
                            "example": "Low",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object",
                        "x-docs-overrides": {
                          "properties.resource_type.example": "enum_option"
                        }
                      },
                      "type": "array"
                    },
                    "enum_value": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                      "nullable": true,
                      "properties": {
                        "color": {
                          "description": "The color of the enum option. Defaults to `none`.",
                          "example": "blue",
                          "type": "string"
                        },
                        "enabled": {
                          "description": "Whether or not the enum option is a selectable value for the custom field.",
                          "example": true,
                          "type": "boolean"
                        },
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "The name of the enum option.",
                          "example": "Low",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "enum_option"
                      }
                    },
                    "format": {
                      "description": "The format of this custom field.",
                      "enum": [
                        "currency",
                        "identifier",
                        "percentage",
                        "custom",
                        "duration",
                        "none"
                      ],
                      "example": "custom",
                      "type": "string"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "has_notifications_enabled": {
                      "description": "*Conditional*. This flag describes whether a follower of a task with this field should receive inbox notifications from changes to this field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "html_text_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `text`. This is the HTML representation of the text value of a custom field, corresponding to the `text_value` plain-text field. See [rich text](/docs/rich-text#reading-rich-text).",
                      "example": "<body>Some Value</body>",
                      "nullable": true,
                      "readOnly": true,
                      "type": "string"
                    },
                    "id_prefix": {
                      "description": "This field is the unique custom ID string for the custom field.",
                      "example": "ID",
                      "nullable": true,
                      "type": "string"
                    },
                    "input_restrictions": {
                      "example": [
                        "task"
                      ],
                      "items": {
                        "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                        "enum": [
                          "task",
                          "project",
                          "portfolio",
                          "goal"
                        ],
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "is_formula_field": {
                      "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                      "example": false,
                      "type": "boolean"
                    },
                    "is_global_to_workspace": {
                      "description": "This flag describes whether this custom field is available to every container in the workspace. Before project-specific custom fields, this field was always true.",
                      "example": true,
                      "readOnly": true,
                      "type": "boolean"
                    },
                    "is_lookup_field": {
                      "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                      "example": false,
                      "type": "boolean"
                    },
                    "is_value_read_only": {
                      "description": "*Conditional*. This flag describes whether a custom field is read only.",
                      "example": false,
                      "type": "boolean"
                    },
                    "multi_enum_values": {
                      "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                        "properties": {
                          "color": {
                            "description": "The color of the enum option. Defaults to `none`.",
                            "example": "blue",
                            "type": "string"
                          },
                          "enabled": {
                            "description": "Whether or not the enum option is a selectable value for the custom field.",
                            "example": true,
                            "type": "boolean"
                          },
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "The name of the enum option.",
                            "example": "Low",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object",
                        "x-docs-overrides": {
                          "properties.resource_type.example": "enum_option"
                        }
                      },
                      "type": "array"
                    },
                    "name": {
                      "description": "The name of the custom field.",
                      "example": "Status",
                      "type": "string"
                    },
                    "number_value": {
                      "description": "*Conditional*. This number is the value of a `number` custom field.",
                      "example": 5.2,
                      "nullable": true,
                      "type": "number"
                    },
                    "people_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `people`. This array of [compact user](/reference/users) objects reflects the values of a `people` custom field.",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                        "properties": {
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "*Read-only except when same user as requester*. The user's name.",
                            "example": "Greg Sanchez",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object",
                        "x-docs-overrides": {
                          "properties.resource_type.example": "user"
                        }
                      },
                      "type": "array"
                    },
                    "precision": {
                      "description": "Only relevant for custom fields of type `Number`. This field dictates the number of places after the decimal to round to, i.e. 0 is integer values, 1 rounds to the nearest tenth, and so on. Must be between 0 and 6, inclusive.\nFor percentage format, this may be unintuitive, as a value of 0.25 has a precision of 0, while a value of 0.251 has a precision of 1. This is due to 0.25 being displayed as 25%.\nThe identifier format will always have a precision of 0.",
                      "example": 2,
                      "type": "integer"
                    },
                    "privacy_setting": {
                      "description": "The privacy setting of the custom field. *Note: Administrators in your organization may restrict the values of `privacy_setting`.*",
                      "enum": [
                        "public_with_guests",
                        "public",
                        "private"
                      ],
                      "example": "public_with_guests",
                      "type": "string"
                    },
                    "reference_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of objects reflects the values of a `reference` custom field.",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.",
                        "properties": {
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "The name of the object.",
                            "example": "Bug Task",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "representation_type": {
                      "description": "This field tells the type of the custom field.",
                      "enum": [
                        "text",
                        "enum",
                        "multi_enum",
                        "number",
                        "date",
                        "people",
                        "formula",
                        "custom_id",
                        "reference"
                      ],
                      "example": "number",
                      "readOnly": true,
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The type of the custom field. Must be one of the given values.\n",
                      "enum": [
                        "text",
                        "enum",
                        "multi_enum",
                        "number",
                        "date",
                        "people",
                        "reference"
                      ],
                      "example": "text",
                      "readOnly": true,
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    },
                    "text_value": {
                      "description": "*Conditional*. This string is the value of a `text` custom field.",
                      "example": "Some Value",
                      "nullable": true,
                      "type": "string"
                    },
                    "type": {
                      "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                      "enum": [
                        "text",
                        "enum",
                        "multi_enum",
                        "number",
                        "date",
                        "people",
                        "reference"
                      ],
                      "readOnly": true,
                      "type": "string"
                    }
                  },
                  "readOnly": true,
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "custom_field"
                  }
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "is_important": {
                  "description": "`is_important` is used in the Asana web application to determine if this custom field is displayed in the list/grid view of a project or portfolio.",
                  "example": false,
                  "readOnly": true,
                  "type": "boolean"
                },
                "parent": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\nThe parent to which the custom field is applied. This can be a project or portfolio and indicates that the tasks or projects that the parent contains may be given custom field values for this custom field.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "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.",
                      "example": "Stuff to buy",
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                      "enum": [
                        "default_project",
                        "custom"
                      ],
                      "example": "default_project",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "readOnly": true,
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "project"
                  }
                },
                "project": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\n*Deprecated: new integrations should prefer the `parent` field.* The id of the project that this custom field settings refers to.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "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.",
                      "example": "Stuff to buy",
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                      "enum": [
                        "default_project",
                        "custom"
                      ],
                      "example": "default_project",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "readOnly": true,
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "project"
                  }
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "custom_field_setting"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "custom_fields": {
            "description": "Array of custom field values applied directly to the project itself. These represent the values set on the project, not the fields available for tasks in the project.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.",
              "properties": {
                "date_value": {
                  "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                  "nullable": true,
                  "properties": {
                    "date": {
                      "description": "A string representing the date in YYYY-MM-DD format.",
                      "example": "2024-08-23",
                      "type": "string"
                    },
                    "date_time": {
                      "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                      "example": "2024-08-23T22:00:00.000Z",
                      "type": "string"
                    }
                  },
                  "type": "object"
                },
                "display_value": {
                  "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                  "example": "blue",
                  "nullable": true,
                  "readOnly": true,
                  "type": "string"
                },
                "enabled": {
                  "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                  "example": true,
                  "readOnly": true,
                  "type": "boolean"
                },
                "enum_options": {
                  "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                  "items": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                    "properties": {
                      "color": {
                        "description": "The color of the enum option. Defaults to `none`.",
                        "example": "blue",
                        "type": "string"
                      },
                      "enabled": {
                        "description": "Whether or not the enum option is a selectable value for the custom field.",
                        "example": true,
                        "type": "boolean"
                      },
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "The name of the enum option.",
                        "example": "Low",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "enum_option"
                    }
                  },
                  "type": "array"
                },
                "enum_value": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                  "nullable": true,
                  "properties": {
                    "color": {
                      "description": "The color of the enum option. Defaults to `none`.",
                      "example": "blue",
                      "type": "string"
                    },
                    "enabled": {
                      "description": "Whether or not the enum option is a selectable value for the custom field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the enum option.",
                      "example": "Low",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "enum_option"
                  }
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "id_prefix": {
                  "description": "This field is the unique custom ID string for the custom field.",
                  "example": "ID",
                  "nullable": true,
                  "type": "string"
                },
                "input_restrictions": {
                  "example": [
                    "task"
                  ],
                  "items": {
                    "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                    "enum": [
                      "task",
                      "project",
                      "portfolio",
                      "goal"
                    ],
                    "type": "string"
                  },
                  "type": "array"
                },
                "is_formula_field": {
                  "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                  "example": false,
                  "type": "boolean"
                },
                "is_lookup_field": {
                  "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                  "example": false,
                  "type": "boolean"
                },
                "multi_enum_values": {
                  "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                  "items": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                    "properties": {
                      "color": {
                        "description": "The color of the enum option. Defaults to `none`.",
                        "example": "blue",
                        "type": "string"
                      },
                      "enabled": {
                        "description": "Whether or not the enum option is a selectable value for the custom field.",
                        "example": true,
                        "type": "boolean"
                      },
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "The name of the enum option.",
                        "example": "Low",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "enum_option"
                    }
                  },
                  "type": "array"
                },
                "name": {
                  "description": "The name of the custom field.",
                  "example": "Status",
                  "type": "string"
                },
                "number_value": {
                  "description": "*Conditional*. This number is the value of a `number` custom field.",
                  "example": 5.2,
                  "nullable": true,
                  "type": "number"
                },
                "representation_type": {
                  "description": "This field tells the type of the custom field.",
                  "enum": [
                    "text",
                    "enum",
                    "multi_enum",
                    "number",
                    "date",
                    "people",
                    "formula",
                    "custom_id",
                    "reference"
                  ],
                  "example": "number",
                  "readOnly": true,
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                },
                "text_value": {
                  "description": "*Conditional*. This string is the value of a `text` custom field.",
                  "example": "Some Value",
                  "nullable": true,
                  "type": "string"
                },
                "type": {
                  "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                  "enum": [
                    "text",
                    "enum",
                    "multi_enum",
                    "number",
                    "date",
                    "people",
                    "reference"
                  ],
                  "readOnly": true,
                  "type": "string"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "custom_field"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "custom_type": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Types extend the types of Asana Objects.",
            "nullable": true,
            "properties": {
              "asana_created_type_identifier": {
                "description": "*Read-only*. A stable identifier present when this custom type was created by Asana as part of an Asana product (for example, a Command ticket type or a Service queue type). `null` for custom types created by users, and for Asana-created types that do not have a public identifier yet. New values may be added over time as Asana products introduce new types; integrations should tolerate unrecognized values.",
                "enum": [
                  "COMMAND_TICKET",
                  "COMMAND_RELEASE",
                  "COMMAND_TEAMSPACE",
                  "SERVICE_TICKET",
                  "SERVICE_CONVERSATION",
                  "SERVICE_QUEUE"
                ],
                "example": "COMMAND_TICKET",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the custom type.",
                "example": "Bug ticket",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "custom_type"
            }
          },
          "default_access_level": {
            "description": "The default access for users or teams who join or are added as members to the project.",
            "enum": [
              "admin",
              "editor",
              "commenter",
              "viewer"
            ],
            "example": "admin",
            "type": "string"
          },
          "default_view": {
            "description": "The default view (list, board, calendar, or timeline) of a project.",
            "enum": [
              "list",
              "board",
              "calendar",
              "timeline"
            ],
            "example": "calendar",
            "type": "string"
          },
          "due_date": {
            "description": "*Deprecated: new integrations should prefer the `due_on` field.*",
            "example": "2019-09-15",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "due_on": {
            "description": "The day on which this project is due. This takes a date with format YYYY-MM-DD.",
            "example": "2019-09-15",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "followers": {
            "description": "Array of users following this project. Followers are a subset of members who have opted in to receive \"tasks added\" notifications for a project.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "*Read-only except when same user as requester*. The user's name.",
                  "example": "Greg Sanchez",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "user"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_notes": {
            "description": "[Opt In](/docs/inputoutput-options). The notes of the project with formatting as HTML. See [rich text](/docs/rich-text).",
            "example": "<body>These are things we need to purchase.</body>",
            "type": "string"
          },
          "icon": {
            "description": "The icon for a project.",
            "enum": [
              "list",
              "board",
              "timeline",
              "calendar",
              "rocket",
              "people",
              "graph",
              "star",
              "bug",
              "light_bulb",
              "globe",
              "gear",
              "notebook",
              "computer",
              "check",
              "target",
              "html",
              "megaphone",
              "chat_bubbles",
              "briefcase",
              "page_layout",
              "mountain_flag",
              "puzzle",
              "presentation",
              "line_and_symbols",
              "speed_dial",
              "ribbon",
              "shoe",
              "shopping_basket",
              "map",
              "ticket",
              "coins"
            ],
            "example": "chat_bubbles",
            "nullable": true,
            "type": "string"
          },
          "members": {
            "description": "Array of users who are members of this project.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "*Read-only except when same user as requester*. The user's name.",
                  "example": "Greg Sanchez",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "user"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "minimum_access_level_for_customization": {
            "description": "The minimum access level needed for project members to modify this project's workflow and appearance.",
            "enum": [
              "admin",
              "editor"
            ],
            "example": "admin",
            "type": "string"
          },
          "minimum_access_level_for_sharing": {
            "description": "The minimum access level needed for project members to share the project and manage project memberships.",
            "enum": [
              "admin",
              "editor"
            ],
            "example": "admin",
            "type": "string"
          },
          "modified_at": {
            "description": "The time at which this project was last modified.\n*Note: This does not currently reflect any changes in associations such as tasks or comments that may have been added or removed from the project.*",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "name": {
            "description": "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.",
            "example": "Stuff to buy",
            "type": "string"
          },
          "notes": {
            "description": "Free-form textual information associated with the project (ie., its description).",
            "example": "These are things we need to purchase.",
            "type": "string"
          },
          "owner": {
            "allOf": [
              {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              {
                "type": "object"
              }
            ],
            "description": "The current owner of the project, may be null.",
            "nullable": true
          },
          "permalink_url": {
            "description": "A url that points directly to the object within Asana.",
            "example": "https://app.asana.com/1/12345/project/123456789",
            "readOnly": true,
            "type": "string"
          },
          "privacy_setting": {
            "description": "The privacy setting of the project. *Note: Administrators in your organization may restrict the values of `privacy_setting`.* The value `private_to_team` is deprecated. Use `POST /memberships` to share a project with a team after creation.",
            "enum": [
              "public_to_workspace",
              "private_to_team",
              "private"
            ],
            "example": "public_to_workspace",
            "type": "string"
          },
          "project_brief": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *Project Brief* allows you to explain the what and why of the project to your team.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *Project Brief* allows you to explain the what and why of the project to your team.\n[Opt In](/docs/inputoutput-options). The project brief associated with this project.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project_brief"
            }
          },
          "public": {
            "deprecated": true,
            "description": "*Deprecated:* new integrations use `privacy_setting` instead.",
            "example": false,
            "type": "boolean"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "enum": [
              "default_project",
              "custom"
            ],
            "example": "default_project",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_on": {
            "description": "The day on which work for this project begins, or null if the project has no start date. This takes a date with `YYYY-MM-DD` format. *Note: `due_on` or `due_at` must be present in the request when setting or unsetting the `start_on` parameter. Additionally, `start_on` and `due_on` cannot be the same date.*",
            "example": "2019-09-14",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "team": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *team* is used to group related projects and people together within an organization. Each project in an organization is associated with a team.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *team* is used to group related projects and people together within an organization. Each project in an organization is associated with a team.\nThe team that this project is shared with.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the team.",
                "example": "Marketing",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "team"
            }
          },
          "workspace": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.\n*Create-only*. The workspace or organization this project is associated with. Once created, projects cannot be moved to a different workspace. This attribute can only be specified at creation time. If the workspace for your project is an organization, you must also supply a `team` in the request body.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the workspace.",
                "example": "My Company Workspace",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "workspace"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "project"
        }
      },
      "sdk__ProjectResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__ProjectResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__ProjectResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__ProjectResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__ProjectSaveAsTemplateRequest": {
        "properties": {
          "name": {
            "description": "The name of the new project template.",
            "example": "New Project Template",
            "type": "string"
          },
          "public": {
            "description": "Sets the project template to public to its team.",
            "example": true,
            "type": "boolean"
          },
          "team": {
            "description": "Sets the team of the new project template. If the project exists in an organization, specify team and not workspace.",
            "example": "12345",
            "type": "string"
          },
          "workspace": {
            "description": "Sets the workspace of the new project template. Only specify workspace if the project exists in a workspace.",
            "example": "12345",
            "type": "string"
          }
        },
        "required": [
          "name",
          "public"
        ],
        "type": "object"
      },
      "sdk__ProjectSectionInsertRequest": {
        "properties": {
          "after_section": {
            "description": "Insert the given section immediately after the section specified by this parameter.",
            "example": "987654",
            "type": "string"
          },
          "before_section": {
            "description": "Insert the given section immediately before the section specified by this parameter.",
            "example": "86420",
            "type": "string"
          },
          "section": {
            "description": "The section to reorder.",
            "example": "321654",
            "type": "string"
          }
        },
        "required": [
          "section"
        ],
        "type": "object"
      },
      "sdk__ProjectStatusBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\n*Deprecated: new integrations should prefer the `status_update` resource.*\nA *project status* is an update on the progress of a particular project, and is sent out to all project followers when created. These updates include both text describing the update and a color code intended to represent the overall state of the project: \"green\" for projects that are on track, \"yellow\" for projects at risk, and \"red\" for projects that are behind.",
        "properties": {
          "color": {
            "description": "The color associated with the status update.",
            "enum": [
              "green",
              "yellow",
              "red",
              "blue",
              "complete"
            ],
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_text": {
            "description": "[Opt In](/docs/inputoutput-options). The text content of the status update with formatting as HTML. See [rich text](/docs/rich-text).",
            "example": "<body>The project <strong>is</strong> moving forward according to plan...</body>",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "text": {
            "description": "The text content of the status update.",
            "example": "The project is moving forward according to plan...",
            "type": "string"
          },
          "title": {
            "description": "The title of the project status update.",
            "example": "Status Update - Jun 15",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "project_status"
        }
      },
      "sdk__ProjectStatusCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\n*Deprecated: new integrations should prefer the `status_update` resource.*\nA *project status* is an update on the progress of a particular project, and is sent out to all project followers when created. These updates include both text describing the update and a color code intended to represent the overall state of the project: \"green\" for projects that are on track, \"yellow\" for projects at risk, and \"red\" for projects that are behind.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "title": {
            "description": "The title of the project status update.",
            "example": "Status Update - Jun 15",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "project_status"
        }
      },
      "sdk__ProjectStatusRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\n*Deprecated: new integrations should prefer the `status_update` resource.*\nA *project status* is an update on the progress of a particular project, and is sent out to all project followers when created. These updates include both text describing the update and a color code intended to represent the overall state of the project: \"green\" for projects that are on track, \"yellow\" for projects at risk, and \"red\" for projects that are behind.",
        "properties": {
          "color": {
            "description": "The color associated with the status update.",
            "enum": [
              "green",
              "yellow",
              "red",
              "blue",
              "complete"
            ],
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_text": {
            "description": "[Opt In](/docs/inputoutput-options). The text content of the status update with formatting as HTML. See [rich text](/docs/rich-text).",
            "example": "<body>The project <strong>is</strong> moving forward according to plan...</body>",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "text": {
            "description": "The text content of the status update.",
            "example": "The project is moving forward according to plan...",
            "type": "string"
          },
          "title": {
            "description": "The title of the project status update.",
            "example": "Status Update - Jun 15",
            "type": "string"
          }
        },
        "required": [
          "color"
        ],
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "project_status"
        }
      },
      "sdk__ProjectStatusResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\n*Deprecated: new integrations should prefer the `status_update` resource.*\nA *project status* is an update on the progress of a particular project, and is sent out to all project followers when created. These updates include both text describing the update and a color code intended to represent the overall state of the project: \"green\" for projects that are on track, \"yellow\" for projects at risk, and \"red\" for projects that are behind.",
        "properties": {
          "author": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "color": {
            "description": "The color associated with the status update.",
            "enum": [
              "green",
              "yellow",
              "red",
              "blue",
              "complete"
            ],
            "type": "string"
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "created_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_text": {
            "description": "[Opt In](/docs/inputoutput-options). The text content of the status update with formatting as HTML. See [rich text](/docs/rich-text).",
            "example": "<body>The project <strong>is</strong> moving forward according to plan...</body>",
            "type": "string"
          },
          "modified_at": {
            "description": "The time at which this project status was last modified.\n*Note: This does not currently reflect any changes in associations such as comments that may have been added or removed from the project status.*",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "text": {
            "description": "The text content of the status update.",
            "example": "The project is moving forward according to plan...",
            "type": "string"
          },
          "title": {
            "description": "The title of the project status update.",
            "example": "Status Update - Jun 15",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "project_status"
        }
      },
      "sdk__ProjectStatusResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__ProjectStatusResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__ProjectStatusResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__ProjectStatusResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__ProjectTemplateBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project template* is an object that allows new projects to be created with a predefined setup, which may include tasks, sections, Rules, etc. It simplifies the process of running a workflow that involves a similar set of work every time.",
        "properties": {
          "color": {
            "description": "Color of the project template.",
            "enum": [
              "dark-pink",
              "dark-green",
              "dark-blue",
              "dark-red",
              "dark-teal",
              "dark-brown",
              "dark-orange",
              "dark-purple",
              "dark-warm-gray",
              "light-pink",
              "light-green",
              "light-blue",
              "light-red",
              "light-teal",
              "light-brown",
              "light-orange",
              "light-purple",
              "light-warm-gray",
              null
            ],
            "example": "light-green",
            "nullable": true,
            "type": "string"
          },
          "description": {
            "description": "Free-form textual information associated with the project template",
            "example": "These are things we need to pack for a trip.",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_description": {
            "description": "The description of the project template with formatting as HTML. See [rich text](/docs/rich-text#reading-rich-text).",
            "example": "<body>These are things we need to pack for a trip.</body>",
            "type": "string"
          },
          "name": {
            "description": "Name of the project template.",
            "example": "Packing list",
            "type": "string"
          },
          "owner": {
            "allOf": [
              {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              {
                "type": "object"
              }
            ],
            "description": "The current owner of the project template, may be null.",
            "nullable": true
          },
          "public": {
            "description": "True if the project template is public to its team.",
            "example": false,
            "type": "boolean"
          },
          "requested_dates": {
            "description": "Array of date variables in this project template. Calendar dates must be provided for these variables when instantiating a project.",
            "items": {
              "properties": {
                "description": {
                  "description": "The description of what the date variable is used for when instantiating a project.",
                  "example": "Choose a start date for your project.",
                  "readOnly": true,
                  "type": "string"
                },
                "gid": {
                  "description": "Globally unique identifier of the date field in the project template. A value of `1` refers to the project start date, while `2` refers to the project due date.",
                  "example": "1",
                  "readOnly": true,
                  "type": "string"
                },
                "name": {
                  "description": "The name of the date variable.",
                  "example": "Start Date",
                  "readOnly": true,
                  "type": "string"
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "requested_roles": {
            "description": "Array of template roles in this project template. User Ids can be provided for these variables when instantiating a project to assign template tasks to the user.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "Name of the template role.",
                  "example": "Designer",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "team": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *team* is used to group related projects and people together within an organization. Each project in an organization is associated with a team.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the team.",
                "example": "Marketing",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "team"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "project_template"
        }
      },
      "sdk__ProjectTemplateCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project template* is an object that allows new projects to be created with a predefined setup, which may include tasks, sections, Rules, etc. It simplifies the process of running a workflow that involves a similar set of work every time.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "Name of the project template.",
            "example": "Packing list",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "project_template"
        }
      },
      "sdk__ProjectTemplateInstantiateProjectRequest": {
        "properties": {
          "is_strict": {
            "description": "*Optional*. If set to `true`, the endpoint returns an \"Unprocessable Entity\" error if you fail to provide a calendar date value for any date variable. If set to `false`, a default date is used for each unfulfilled date variable (e.g., the current date is used as the Start Date of a project).",
            "example": true,
            "type": "boolean"
          },
          "name": {
            "description": "The name of the new project.",
            "example": "New Project Name",
            "type": "string"
          },
          "privacy_setting": {
            "description": "The privacy setting of the project. *Note: Administrators in your organization may restrict the values of `privacy_setting`.* The value `private_to_team` is deprecated. Use `POST /memberships` to share a project with a team after creation.",
            "enum": [
              "public_to_workspace",
              "private_to_team",
              "private"
            ],
            "example": "public_to_workspace",
            "type": "string"
          },
          "public": {
            "deprecated": true,
            "description": "*Deprecated:* new integrations use `privacy_setting` instead.",
            "example": true,
            "type": "boolean"
          },
          "requested_dates": {
            "description": "*Conditional*. Array of mappings of date variables to calendar dates. This property is required in the instantiation request if the project template includes dates (e.g., a start date on a task).",
            "items": {
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the date field in the project template. A value of `1` refers to the project start date, while `2` refers to the project due date.",
                  "example": "1",
                  "type": "string"
                },
                "value": {
                  "description": "The date with which the date variable should be replaced when instantiating a project. This takes a date with `YYYY-MM-DD` format.",
                  "example": "2022-01-01",
                  "format": "date-time",
                  "nullable": true,
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "requested_roles": {
            "description": "Array of mappings of template roles to users.",
            "items": {
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the template role in the project template.",
                  "example": "1",
                  "type": "string"
                },
                "value": {
                  "description": "A string identifying a user that should be assigned to the template role. This can either be the string \"me\", an email, or the gid of a user.",
                  "example": "123",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "team": {
            "description": "*Optional*. Sets the team of the new project. If the project template exists in an _organization_, you may specify a value for `team`. If no value is provided then it defaults to the same team as the project template.",
            "example": "12345",
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "sdk__ProjectTemplateResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project template* is an object that allows new projects to be created with a predefined setup, which may include tasks, sections, Rules, etc. It simplifies the process of running a workflow that involves a similar set of work every time.",
        "properties": {
          "color": {
            "description": "Color of the project template.",
            "enum": [
              "dark-pink",
              "dark-green",
              "dark-blue",
              "dark-red",
              "dark-teal",
              "dark-brown",
              "dark-orange",
              "dark-purple",
              "dark-warm-gray",
              "light-pink",
              "light-green",
              "light-blue",
              "light-red",
              "light-teal",
              "light-brown",
              "light-orange",
              "light-purple",
              "light-warm-gray",
              null
            ],
            "example": "light-green",
            "nullable": true,
            "type": "string"
          },
          "description": {
            "description": "Free-form textual information associated with the project template",
            "example": "These are things we need to pack for a trip.",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_description": {
            "description": "The description of the project template with formatting as HTML. See [rich text](/docs/rich-text#reading-rich-text).",
            "example": "<body>These are things we need to pack for a trip.</body>",
            "type": "string"
          },
          "name": {
            "description": "Name of the project template.",
            "example": "Packing list",
            "type": "string"
          },
          "owner": {
            "allOf": [
              {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              {
                "type": "object"
              }
            ],
            "description": "The current owner of the project template, may be null.",
            "nullable": true
          },
          "public": {
            "description": "True if the project template is public to its team.",
            "example": false,
            "type": "boolean"
          },
          "requested_dates": {
            "description": "Array of date variables in this project template. Calendar dates must be provided for these variables when instantiating a project.",
            "items": {
              "properties": {
                "description": {
                  "description": "The description of what the date variable is used for when instantiating a project.",
                  "example": "Choose a start date for your project.",
                  "readOnly": true,
                  "type": "string"
                },
                "gid": {
                  "description": "Globally unique identifier of the date field in the project template. A value of `1` refers to the project start date, while `2` refers to the project due date.",
                  "example": "1",
                  "readOnly": true,
                  "type": "string"
                },
                "name": {
                  "description": "The name of the date variable.",
                  "example": "Start Date",
                  "readOnly": true,
                  "type": "string"
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "requested_roles": {
            "description": "Array of template roles in this project template. User Ids can be provided for these variables when instantiating a project to assign template tasks to the user.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "Name of the template role.",
                  "example": "Designer",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "team": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *team* is used to group related projects and people together within an organization. Each project in an organization is associated with a team.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the team.",
                "example": "Marketing",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "team"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "project_template"
        }
      },
      "sdk__ProjectTemplateResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__ProjectTemplateResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__ProjectTemplateResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__ProjectTemplateResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__ProjectUpdateRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
        "properties": {
          "archived": {
            "description": "True if the project is archived, false if not. Archived projects do not show in the UI by default and may be treated differently for queries.",
            "example": false,
            "type": "boolean"
          },
          "color": {
            "description": "Color of the project.",
            "enum": [
              "dark-pink",
              "dark-green",
              "dark-blue",
              "dark-red",
              "dark-teal",
              "dark-brown",
              "dark-orange",
              "dark-purple",
              "dark-warm-gray",
              "light-pink",
              "light-green",
              "light-blue",
              "light-red",
              "light-teal",
              "light-brown",
              "light-orange",
              "light-purple",
              "light-warm-gray",
              "none",
              null
            ],
            "example": "light-green",
            "nullable": true,
            "type": "string"
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "current_status": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\n*Deprecated: new integrations should prefer the `status_update` resource.*\nA *project status* is an update on the progress of a particular project, and is sent out to all project followers when created. These updates include both text describing the update and a color code intended to represent the overall state of the project: \"green\" for projects that are on track, \"yellow\" for projects at risk, and \"red\" for projects that are behind.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\n*Deprecated: new integrations should prefer the `status_update` resource.*\nA *project status* is an update on the progress of a particular project, and is sent out to all project followers when created. These updates include both text describing the update and a color code intended to represent the overall state of the project: \"green\" for projects that are on track, \"yellow\" for projects at risk, and \"red\" for projects that are behind.\n*Deprecated: new integrations should prefer the `current_status_update` resource.*",
            "nullable": true,
            "properties": {
              "author": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "color": {
                "description": "The color associated with the status update.",
                "enum": [
                  "green",
                  "yellow",
                  "red",
                  "blue",
                  "complete"
                ],
                "type": "string"
              },
              "created_at": {
                "description": "The time at which this resource was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "created_by": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "html_text": {
                "description": "[Opt In](/docs/inputoutput-options). The text content of the status update with formatting as HTML. See [rich text](/docs/rich-text).",
                "example": "<body>The project <strong>is</strong> moving forward according to plan...</body>",
                "type": "string"
              },
              "modified_at": {
                "description": "The time at which this project status was last modified.\n*Note: This does not currently reflect any changes in associations such as comments that may have been added or removed from the project status.*",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              },
              "text": {
                "description": "The text content of the status update.",
                "example": "The project is moving forward according to plan...",
                "type": "string"
              },
              "title": {
                "description": "The title of the project status update.",
                "example": "Status Update - Jun 15",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project_status"
            }
          },
          "current_status_update": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *status update* is an update on the progress of a particular project, portfolio, or goal, and is sent out to all of its parent's followers when created. These updates include both text describing the update and a `status_type` intended to represent the overall state of the object.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *status update* is an update on the progress of a particular project, portfolio, or goal, and is sent out to all of its parent's followers when created. These updates include both text describing the update and a `status_type` intended to represent the overall state of the object.\nThe latest `status_update` posted to this project.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe `resource_subtype`s for `status` objects represent the type of their parent.",
                "enum": [
                  "project_status_update",
                  "portfolio_status_update",
                  "goal_status_update"
                ],
                "example": "project_status_update",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              },
              "title": {
                "description": "The title of the status update.",
                "example": "Status Update - Jun 15",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "status_update"
            }
          },
          "custom_field_settings": {
            "description": "Array of custom field definitions that are enabled for the project. These represent which custom fields are available to be used on tasks within the project, but do not include any values.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields Settings objects represent the many-to-many join of the Custom Field and Project as well as stores information that is relevant to that particular pairing.",
              "properties": {
                "custom_field": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.\nThe custom field that is applied to the `parent`.",
                  "properties": {
                    "asana_created_field": {
                      "description": "*Conditional*. A unique identifier to associate this field with the template source of truth.",
                      "enum": [
                        "a_v_requirements",
                        "account_name",
                        "actionable",
                        "align_shipping_link",
                        "align_status",
                        "allotted_time",
                        "appointment",
                        "approval_stage",
                        "approved",
                        "article_series",
                        "board_committee",
                        "browser",
                        "campaign_audience",
                        "campaign_project_status",
                        "campaign_regions",
                        "channel_primary",
                        "client_topic_type",
                        "complete_by",
                        "contact",
                        "contact_email_address",
                        "content_channels",
                        "content_channels_needed",
                        "content_stage",
                        "content_type",
                        "contract",
                        "contract_status",
                        "cost",
                        "creation_stage",
                        "creative_channel",
                        "creative_needed",
                        "creative_needs",
                        "data_sensitivity",
                        "deal_size",
                        "delivery_appt",
                        "delivery_appt_date",
                        "department",
                        "department_responsible",
                        "design_request_needed",
                        "design_request_type",
                        "discussion_category",
                        "do_this_task",
                        "editorial_content_status",
                        "editorial_content_tag",
                        "editorial_content_type",
                        "effort",
                        "effort_level",
                        "est_completion_date",
                        "estimated_time",
                        "estimated_value",
                        "expected_cost",
                        "external_steps_needed",
                        "favorite_idea",
                        "feedback_type",
                        "financial",
                        "funding_amount",
                        "grant_application_process",
                        "hiring_candidate_status",
                        "idea_status",
                        "ids_link",
                        "ids_patient_link",
                        "implementation_stage",
                        "insurance",
                        "interview_area",
                        "interview_question_score",
                        "itero_scan_link",
                        "job_s_applied_to",
                        "lab",
                        "launch_status",
                        "lead_status",
                        "localization_language",
                        "localization_market_team",
                        "localization_status",
                        "meeting_minutes",
                        "meeting_needed",
                        "minutes",
                        "mrr",
                        "must_localize",
                        "name_of_foundation",
                        "need_to_follow_up",
                        "next_appointment",
                        "next_steps_sales",
                        "num_people",
                        "number_of_user_reports",
                        "office_location",
                        "onboarding_activity",
                        "owner",
                        "participants_needed",
                        "patient_date_of_birth",
                        "patient_email",
                        "patient_phone",
                        "patient_status",
                        "phone_number",
                        "planning_category",
                        "point_of_contact",
                        "position",
                        "post_format",
                        "prescription",
                        "priority",
                        "priority_level",
                        "product",
                        "product_stage",
                        "progress",
                        "project_size",
                        "project_status",
                        "proposed_budget",
                        "publish_status",
                        "reason_for_scan",
                        "referral",
                        "request_type",
                        "research_status",
                        "responsible_department",
                        "responsible_team",
                        "risk_assessment_status",
                        "room_name",
                        "sales_counterpart",
                        "sentiment",
                        "shipping_link",
                        "social_channels",
                        "stage",
                        "status",
                        "status_design",
                        "status_of_initiative",
                        "system_setup",
                        "task_progress",
                        "team",
                        "team_marketing",
                        "team_responsible",
                        "time_it_takes_to_complete_tasks",
                        "timeframe",
                        "treatment_type",
                        "type_work_requests_it",
                        "use_agency",
                        "user_name",
                        "vendor_category",
                        "vendor_type",
                        "word_count",
                        null
                      ],
                      "example": "priority",
                      "nullable": true,
                      "readOnly": true,
                      "type": "string"
                    },
                    "created_by": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                      "nullable": true,
                      "properties": {
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "*Read-only except when same user as requester*. The user's name.",
                          "example": "Greg Sanchez",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "user"
                      }
                    },
                    "currency_code": {
                      "description": "ISO 4217 currency code to format this custom field. This will be null if the `format` is not `currency`.",
                      "example": "EUR",
                      "nullable": true,
                      "type": "string"
                    },
                    "custom_label": {
                      "description": "This is the string that appears next to the custom field value. This will be null if the `format` is not `custom`.",
                      "example": "gold pieces",
                      "nullable": true,
                      "type": "string"
                    },
                    "custom_label_position": {
                      "description": "Only relevant for custom fields with `custom` format. This depicts where to place the custom label. This will be null if the `format` is not `custom`.",
                      "enum": [
                        "prefix",
                        "suffix",
                        null
                      ],
                      "example": "suffix",
                      "nullable": true,
                      "type": "string"
                    },
                    "date_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                      "nullable": true,
                      "properties": {
                        "date": {
                          "description": "A string representing the date in YYYY-MM-DD format.",
                          "example": "2024-08-23",
                          "type": "string"
                        },
                        "date_time": {
                          "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                          "example": "2024-08-23T22:00:00.000Z",
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    "default_access_level": {
                      "description": "The default access level when inviting new members to the custom field. This isn't applied when the `privacy_setting` is `private`, or the user is a guest. For local fields in a project or portfolio, the user must additionally have permission to modify the container itself.",
                      "enum": [
                        "admin",
                        "editor",
                        "user"
                      ],
                      "example": "user",
                      "type": "string"
                    },
                    "description": {
                      "description": "[Opt In](/docs/inputoutput-options). The description of the custom field.",
                      "example": "Development team priority",
                      "type": "string"
                    },
                    "display_value": {
                      "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                      "example": "blue",
                      "nullable": true,
                      "readOnly": true,
                      "type": "string"
                    },
                    "enabled": {
                      "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                      "example": true,
                      "readOnly": true,
                      "type": "boolean"
                    },
                    "enum_options": {
                      "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                        "properties": {
                          "color": {
                            "description": "The color of the enum option. Defaults to `none`.",
                            "example": "blue",
                            "type": "string"
                          },
                          "enabled": {
                            "description": "Whether or not the enum option is a selectable value for the custom field.",
                            "example": true,
                            "type": "boolean"
                          },
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "The name of the enum option.",
                            "example": "Low",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object",
                        "x-docs-overrides": {
                          "properties.resource_type.example": "enum_option"
                        }
                      },
                      "type": "array"
                    },
                    "enum_value": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                      "nullable": true,
                      "properties": {
                        "color": {
                          "description": "The color of the enum option. Defaults to `none`.",
                          "example": "blue",
                          "type": "string"
                        },
                        "enabled": {
                          "description": "Whether or not the enum option is a selectable value for the custom field.",
                          "example": true,
                          "type": "boolean"
                        },
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "The name of the enum option.",
                          "example": "Low",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "enum_option"
                      }
                    },
                    "format": {
                      "description": "The format of this custom field.",
                      "enum": [
                        "currency",
                        "identifier",
                        "percentage",
                        "custom",
                        "duration",
                        "none"
                      ],
                      "example": "custom",
                      "type": "string"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "has_notifications_enabled": {
                      "description": "*Conditional*. This flag describes whether a follower of a task with this field should receive inbox notifications from changes to this field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "html_text_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `text`. This is the HTML representation of the text value of a custom field, corresponding to the `text_value` plain-text field. See [rich text](/docs/rich-text#reading-rich-text).",
                      "example": "<body>Some Value</body>",
                      "nullable": true,
                      "readOnly": true,
                      "type": "string"
                    },
                    "id_prefix": {
                      "description": "This field is the unique custom ID string for the custom field.",
                      "example": "ID",
                      "nullable": true,
                      "type": "string"
                    },
                    "input_restrictions": {
                      "example": [
                        "task"
                      ],
                      "items": {
                        "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                        "enum": [
                          "task",
                          "project",
                          "portfolio",
                          "goal"
                        ],
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "is_formula_field": {
                      "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                      "example": false,
                      "type": "boolean"
                    },
                    "is_global_to_workspace": {
                      "description": "This flag describes whether this custom field is available to every container in the workspace. Before project-specific custom fields, this field was always true.",
                      "example": true,
                      "readOnly": true,
                      "type": "boolean"
                    },
                    "is_lookup_field": {
                      "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                      "example": false,
                      "type": "boolean"
                    },
                    "is_value_read_only": {
                      "description": "*Conditional*. This flag describes whether a custom field is read only.",
                      "example": false,
                      "type": "boolean"
                    },
                    "multi_enum_values": {
                      "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                        "properties": {
                          "color": {
                            "description": "The color of the enum option. Defaults to `none`.",
                            "example": "blue",
                            "type": "string"
                          },
                          "enabled": {
                            "description": "Whether or not the enum option is a selectable value for the custom field.",
                            "example": true,
                            "type": "boolean"
                          },
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "The name of the enum option.",
                            "example": "Low",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object",
                        "x-docs-overrides": {
                          "properties.resource_type.example": "enum_option"
                        }
                      },
                      "type": "array"
                    },
                    "name": {
                      "description": "The name of the custom field.",
                      "example": "Status",
                      "type": "string"
                    },
                    "number_value": {
                      "description": "*Conditional*. This number is the value of a `number` custom field.",
                      "example": 5.2,
                      "nullable": true,
                      "type": "number"
                    },
                    "people_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `people`. This array of [compact user](/reference/users) objects reflects the values of a `people` custom field.",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                        "properties": {
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "*Read-only except when same user as requester*. The user's name.",
                            "example": "Greg Sanchez",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object",
                        "x-docs-overrides": {
                          "properties.resource_type.example": "user"
                        }
                      },
                      "type": "array"
                    },
                    "precision": {
                      "description": "Only relevant for custom fields of type `Number`. This field dictates the number of places after the decimal to round to, i.e. 0 is integer values, 1 rounds to the nearest tenth, and so on. Must be between 0 and 6, inclusive.\nFor percentage format, this may be unintuitive, as a value of 0.25 has a precision of 0, while a value of 0.251 has a precision of 1. This is due to 0.25 being displayed as 25%.\nThe identifier format will always have a precision of 0.",
                      "example": 2,
                      "type": "integer"
                    },
                    "privacy_setting": {
                      "description": "The privacy setting of the custom field. *Note: Administrators in your organization may restrict the values of `privacy_setting`.*",
                      "enum": [
                        "public_with_guests",
                        "public",
                        "private"
                      ],
                      "example": "public_with_guests",
                      "type": "string"
                    },
                    "reference_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of objects reflects the values of a `reference` custom field.",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.",
                        "properties": {
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "The name of the object.",
                            "example": "Bug Task",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "representation_type": {
                      "description": "This field tells the type of the custom field.",
                      "enum": [
                        "text",
                        "enum",
                        "multi_enum",
                        "number",
                        "date",
                        "people",
                        "formula",
                        "custom_id",
                        "reference"
                      ],
                      "example": "number",
                      "readOnly": true,
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The type of the custom field. Must be one of the given values.\n",
                      "enum": [
                        "text",
                        "enum",
                        "multi_enum",
                        "number",
                        "date",
                        "people",
                        "reference"
                      ],
                      "example": "text",
                      "readOnly": true,
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    },
                    "text_value": {
                      "description": "*Conditional*. This string is the value of a `text` custom field.",
                      "example": "Some Value",
                      "nullable": true,
                      "type": "string"
                    },
                    "type": {
                      "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                      "enum": [
                        "text",
                        "enum",
                        "multi_enum",
                        "number",
                        "date",
                        "people",
                        "reference"
                      ],
                      "readOnly": true,
                      "type": "string"
                    }
                  },
                  "readOnly": true,
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "custom_field"
                  }
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "is_important": {
                  "description": "`is_important` is used in the Asana web application to determine if this custom field is displayed in the list/grid view of a project or portfolio.",
                  "example": false,
                  "readOnly": true,
                  "type": "boolean"
                },
                "parent": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\nThe parent to which the custom field is applied. This can be a project or portfolio and indicates that the tasks or projects that the parent contains may be given custom field values for this custom field.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "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.",
                      "example": "Stuff to buy",
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                      "enum": [
                        "default_project",
                        "custom"
                      ],
                      "example": "default_project",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "readOnly": true,
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "project"
                  }
                },
                "project": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\n*Deprecated: new integrations should prefer the `parent` field.* The id of the project that this custom field settings refers to.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "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.",
                      "example": "Stuff to buy",
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                      "enum": [
                        "default_project",
                        "custom"
                      ],
                      "example": "default_project",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "readOnly": true,
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "project"
                  }
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "custom_field_setting"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "custom_fields": {
            "additionalProperties": {
              "description": "\"{custom_field_gid}\" => Value (can be text, a number, etc.). For date, use format \"YYYY-MM-DD\" (e.g., 2019-09-15). For date-time, use ISO 8601 date string in UTC (e.g., 2019-09-15T02:06:58.147Z).",
              "type": "string"
            },
            "description": "An object where each key is the GID of a custom field and its corresponding value is either an enum GID, string, number, or object (depending on the custom field type). See the [custom fields guide](/docs/custom-fields-guide) for details on creating and updating custom field values.",
            "example": {
              "4578152156": "Not Started",
              "5678904321": "On Hold"
            },
            "type": "object"
          },
          "custom_type": {
            "description": "*Conditional:* You can only set custom_type if project `resource_subtype` is `custom`. GID or globally-unique identifier of a project's custom type. The type must be valid for projects, and some Asana-created custom types cannot be assigned via the API; attempting either returns an error explaining which condition failed.",
            "example": "12345",
            "nullable": true,
            "readOnly": false,
            "type": "string",
            "x-env-variable": true
          },
          "default_access_level": {
            "description": "The default access for users or teams who join or are added as members to the project.",
            "enum": [
              "admin",
              "editor",
              "commenter",
              "viewer"
            ],
            "example": "admin",
            "type": "string"
          },
          "default_view": {
            "description": "The default view (list, board, calendar, or timeline) of a project.",
            "enum": [
              "list",
              "board",
              "calendar",
              "timeline"
            ],
            "example": "calendar",
            "type": "string"
          },
          "due_date": {
            "description": "*Deprecated: new integrations should prefer the `due_on` field.*",
            "example": "2019-09-15",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "due_on": {
            "description": "The day on which this project is due. This takes a date with format YYYY-MM-DD.",
            "example": "2019-09-15",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "followers": {
            "description": "*Create-only*. Comma separated string of users. Followers are a subset of members who have opted in to receive \"tasks added\" notifications for a project.",
            "example": "12345,23456",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_custom_fields": {
            "additionalProperties": {
              "description": "\"{custom_field_gid}\" => HTML string (e.g., \"<body>Text content</body>\")",
              "type": "string"
            },
            "description": "An object where each key is the GID of a text custom field and the corresponding value is a rich text HTML string. Only text-type custom fields support this parameter. Values must be wrapped in <body></body> tags. See the [custom fields guide](/docs/custom-fields-guide) and [rich text](/docs/rich-text) for details on supported formatting.",
            "example": {
              "4578152156": "<body><code>Code block</code></body>",
              "5678904321": "<body><strong>Bold text</strong></body>"
            },
            "type": "object"
          },
          "html_notes": {
            "description": "[Opt In](/docs/inputoutput-options). The notes of the project with formatting as HTML. See [rich text](/docs/rich-text).",
            "example": "<body>These are things we need to purchase.</body>",
            "type": "string"
          },
          "icon": {
            "description": "The icon for a project.",
            "enum": [
              "list",
              "board",
              "timeline",
              "calendar",
              "rocket",
              "people",
              "graph",
              "star",
              "bug",
              "light_bulb",
              "globe",
              "gear",
              "notebook",
              "computer",
              "check",
              "target",
              "html",
              "megaphone",
              "chat_bubbles",
              "briefcase",
              "page_layout",
              "mountain_flag",
              "puzzle",
              "presentation",
              "line_and_symbols",
              "speed_dial",
              "ribbon",
              "shoe",
              "shopping_basket",
              "map",
              "ticket",
              "coins"
            ],
            "example": "chat_bubbles",
            "nullable": true,
            "type": "string"
          },
          "members": {
            "description": "Array of users who are members of this project.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "*Read-only except when same user as requester*. The user's name.",
                  "example": "Greg Sanchez",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "user"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "minimum_access_level_for_customization": {
            "description": "The minimum access level needed for project members to modify this project's workflow and appearance.",
            "enum": [
              "admin",
              "editor"
            ],
            "example": "admin",
            "type": "string"
          },
          "minimum_access_level_for_sharing": {
            "description": "The minimum access level needed for project members to share the project and manage project memberships.",
            "enum": [
              "admin",
              "editor"
            ],
            "example": "admin",
            "type": "string"
          },
          "modified_at": {
            "description": "The time at which this project was last modified.\n*Note: This does not currently reflect any changes in associations such as tasks or comments that may have been added or removed from the project.*",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "name": {
            "description": "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.",
            "example": "Stuff to buy",
            "type": "string"
          },
          "notes": {
            "description": "Free-form textual information associated with the project (ie., its description).",
            "example": "These are things we need to purchase.",
            "type": "string"
          },
          "owner": {
            "description": "The current owner of the project, may be null.",
            "example": "12345",
            "nullable": true,
            "type": "string"
          },
          "privacy_setting": {
            "description": "The privacy setting of the project. *Note: Administrators in your organization may restrict the values of `privacy_setting`.* The value `private_to_team` is deprecated. Use `POST /memberships` to share a project with a team after creation.",
            "enum": [
              "public_to_workspace",
              "private_to_team",
              "private"
            ],
            "example": "public_to_workspace",
            "type": "string"
          },
          "public": {
            "deprecated": true,
            "description": "*Deprecated:* new integrations use `privacy_setting` instead.",
            "example": false,
            "type": "boolean"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "enum": [
              "default_project",
              "custom"
            ],
            "example": "default_project",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_on": {
            "description": "The day on which work for this project begins, or null if the project has no start date. This takes a date with `YYYY-MM-DD` format. *Note: `due_on` or `due_at` must be present in the request when setting or unsetting the `start_on` parameter. Additionally, `start_on` and `due_on` cannot be the same date.*",
            "example": "2019-09-14",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "team": {
            "deprecated": true,
            "description": "*Deprecated:* Updating the team a project is shared with is deprecated. Use `POST /memberships` with `{ parent: project, member: team }` instead to manage team sharing.",
            "example": "12345",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "project"
        }
      },
      "sdk__RateBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *rate* is a monetary value assigned to a resource - `user` or `placeholder` - for a given `parent` object.",
        "properties": {
          "created_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "currency_code": {
            "description": "The currency code of the rate, set at the domain level.",
            "example": "USD",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          "rate": {
            "description": "The monetary value of the rate.",
            "example": 100,
            "type": "number"
          },
          "resource": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "rate"
        }
      },
      "sdk__RateCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *rate* is a monetary value assigned to a resource - `user` or `placeholder` - for a given `parent` object.",
        "properties": {
          "created_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "currency_code": {
            "description": "The currency code of the rate, set at the domain level.",
            "example": "USD",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          "rate": {
            "description": "The monetary value of the rate.",
            "example": 100,
            "type": "number"
          },
          "resource": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "rate"
        }
      },
      "sdk__RateOrPlaceholderCompact": {
        "anyOf": [
          {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *rate* is a monetary value assigned to a resource - `user` or `placeholder` - for a given `parent` object.",
            "properties": {
              "created_by": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "readOnly": true,
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "currency_code": {
                "description": "The currency code of the rate, set at the domain level.",
                "example": "USD",
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "parent": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "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.",
                    "example": "Stuff to buy",
                    "type": "string"
                  },
                  "resource_subtype": {
                    "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                    "enum": [
                      "default_project",
                      "custom"
                    ],
                    "example": "default_project",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "project"
                }
              },
              "rate": {
                "description": "The monetary value of the rate.",
                "example": 100,
                "type": "number"
              },
              "resource": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "rate"
            }
          },
          {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *rate* is a monetary value assigned to a resource - `user` or `placeholder` - for a given `parent` object.",
            "properties": {
              "created_by": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "readOnly": true,
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "currency_code": {
                "description": "The currency code of the rate, set at the domain level.",
                "example": "USD",
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "parent": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "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.",
                    "example": "Stuff to buy",
                    "type": "string"
                  },
                  "resource_subtype": {
                    "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                    "enum": [
                      "default_project",
                      "custom"
                    ],
                    "example": "default_project",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "project"
                }
              },
              "rate": {
                "description": "The monetary value of the rate.",
                "example": 100,
                "type": "number"
              },
              "resource": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *placeholder* object represents a placeholder in Asana that can be used to represent a placeholder user.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The placeholder's name.",
                    "example": "Greg-Placeholder Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "rate"
            }
          }
        ]
      },
      "sdk__RateOrPlaceholderCompactArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__RateOrPlaceholderCompact"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__RateRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "parent": {
            "description": "Globally unique ID of the parent object: project.",
            "example": "12345",
            "type": "string"
          },
          "rate": {
            "description": "The monetary value of the rate.",
            "example": 100,
            "type": "number"
          },
          "resource": {
            "description": "Globally unique ID of the resource object: user or placeholder.",
            "example": "12345",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "required": [
          "parent",
          "resource",
          "rate"
        ],
        "type": "object"
      },
      "sdk__RateResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *rate* is a monetary value assigned to a resource - `user` or `placeholder` - for a given `parent` object.",
        "properties": {
          "created_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "currency_code": {
            "description": "The currency code of the rate, set at the domain level.",
            "example": "USD",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          "rate": {
            "description": "The monetary value of the rate.",
            "example": 100,
            "type": "number"
          },
          "resource": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "rate"
        }
      },
      "sdk__RateResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__RateResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__RateUpdateRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "rate": {
            "description": "The monetary value of the rate.",
            "example": 100,
            "type": "number"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "sdk__RbacRoleBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *role* represents a group of permissions that can be assigned to a user or team.",
        "properties": {
          "base_role_type": {
            "description": "The base role type of the role.",
            "enum": [
              "guest",
              "member",
              "admin",
              "super_admin",
              "csm"
            ],
            "type": "string"
          },
          "creation_time": {
            "description": "The time at which this role was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "description": {
            "description": "The description of the role.",
            "example": "This role has exclusive access to create app and PAT tokens.",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "is_standard_role": {
            "description": "Whether the role is a standard role or a custom role. Defaults to `false`.",
            "example": false,
            "type": "boolean"
          },
          "modified_at": {
            "description": "The time at which this role was last modified.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "name": {
            "description": "The name of the role.",
            "example": "Developer",
            "type": "string"
          },
          "permissions": {
            "description": "The permissions of the role.",
            "properties": {
              "allowed_guest_invites": {
                "description": "Controls what type of email users with this role are allowed to invite",
                "enum": [
                  "all",
                  "none"
                ],
                "example": "all",
                "type": "string"
              },
              "assign_roles": {
                "description": "Controls whether users with this role can assign guest, member, and admin roles to other users",
                "example": true,
                "type": "boolean"
              },
              "create_and_edit_ai_automations": {
                "description": "Controls whether users with this role can create and edit AI automations",
                "example": true,
                "type": "boolean"
              },
              "create_and_edit_ai_teammates": {
                "description": "Controls whether users with this role can create and edit AI teammates",
                "example": true,
                "type": "boolean"
              },
              "create_app_authorization": {
                "description": "Controls whether users with this role can create app authorizations",
                "example": true,
                "type": "boolean"
              },
              "create_global_custom_fields": {
                "description": "Controls whether users with this role can create global custom fields",
                "example": true,
                "type": "boolean"
              },
              "create_goal": {
                "description": "Controls whether users with this role can create goals",
                "example": true,
                "type": "boolean"
              },
              "create_pat_authorization": {
                "description": "Controls whether users with this role can create PAT authorizations",
                "example": true,
                "type": "boolean"
              },
              "create_portfolio": {
                "description": "Controls whether users with this role can create portfolios",
                "example": true,
                "type": "boolean"
              },
              "create_project": {
                "description": "Controls whether users with this role can create projects",
                "example": true,
                "type": "boolean"
              },
              "create_read_only_link": {
                "description": "Controls whether users with this role can create read-only links",
                "example": true,
                "type": "boolean"
              },
              "create_team": {
                "description": "Controls whether users with this role can create teams",
                "example": true,
                "type": "boolean"
              },
              "download_mobile_attachments": {
                "description": "Controls whether users with this role can download attachments from mobile app",
                "example": true,
                "type": "boolean"
              },
              "export_project_data": {
                "description": "Controls whether users with this role can export project data",
                "example": true,
                "type": "boolean"
              },
              "import_data": {
                "description": "Controls whether users with this role can import data into the domain",
                "example": true,
                "type": "boolean"
              },
              "manage_roles": {
                "description": "Controls whether users with this role can create, edit, and delete roles",
                "example": true,
                "type": "boolean"
              },
              "proactive_ai": {
                "description": "Controls whether users with this role can use proactive AI features",
                "example": true,
                "type": "boolean"
              },
              "share_goal_with_domain": {
                "description": "Controls whether users with this role can create company-wide goals",
                "example": true,
                "type": "boolean"
              },
              "share_portfolios_with_org": {
                "description": "Controls whether users with this role can create portfolios that are shared with the organization and share existing portfolios to the organization",
                "example": true,
                "type": "boolean"
              },
              "share_teams_with_org": {
                "description": "Controls whether users with this role can share teams with the organization",
                "example": true,
                "type": "boolean"
              },
              "standard_ai": {
                "description": "Controls whether users with this role can use standard AI features",
                "example": true,
                "type": "boolean"
              },
              "task_deletion_policy": {
                "description": "Determines what tasks users with this role are allowed to delete",
                "enum": [
                  "all",
                  "owned",
                  "none"
                ],
                "example": "all",
                "type": "string"
              },
              "upload_attachments": {
                "description": "Controls whether users with this role can upload attachments",
                "example": true,
                "type": "boolean"
              },
              "view_public_teams": {
                "description": "Controls whether users with this role can view public teams",
                "example": true,
                "type": "boolean"
              },
              "view_shared_with_org_portfolios": {
                "description": "Controls whether users with this role can view portfolios shared with the organization",
                "example": true,
                "type": "boolean"
              },
              "view_shared_with_org_projects": {
                "description": "Controls whether users with this role can view projects shared with the organization",
                "example": true,
                "type": "boolean"
              },
              "view_shared_with_org_tasks": {
                "description": "Controls whether users with this role can view tasks shared with the organization",
                "example": true,
                "type": "boolean"
              }
            },
            "type": "object"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "role"
        }
      },
      "sdk__RbacRoleCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *role* represents a group of permissions that can be assigned to a user or team.",
        "properties": {
          "description": {
            "description": "The description of the role.",
            "example": "This role has exclusive access to create app and PAT tokens.",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "is_standard_role": {
            "description": "Whether the role is a standard role or a custom role. Defaults to `false`.",
            "example": false,
            "type": "boolean"
          },
          "name": {
            "description": "The name of the role.",
            "example": "Developer",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "role"
        }
      },
      "sdk__RbacRoleRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *role* represents a group of permissions that can be assigned to a user or team.",
        "properties": {
          "base_role_type": {
            "description": "The base role type of the role.",
            "enum": [
              "guest",
              "member",
              "admin"
            ],
            "type": "string"
          },
          "creation_time": {
            "description": "The time at which this role was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "description": {
            "description": "The description of the role.",
            "example": "This role has exclusive access to create app and PAT tokens.",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "is_standard_role": {
            "description": "Whether the role is a standard role or a custom role. Defaults to `false`.",
            "example": false,
            "type": "boolean"
          },
          "modified_at": {
            "description": "The time at which this role was last modified.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "name": {
            "description": "The name of the role.",
            "example": "Developer",
            "type": "string"
          },
          "permissions": {
            "description": "The permissions of the role.",
            "properties": {
              "allowed_guest_invites": {
                "description": "Controls what type of email users with this role are allowed to invite",
                "enum": [
                  "all",
                  "none"
                ],
                "example": "all",
                "type": "string"
              },
              "assign_roles": {
                "description": "Controls whether users with this role can assign guest, member, and admin roles to other users",
                "example": true,
                "type": "boolean"
              },
              "create_and_edit_ai_automations": {
                "description": "Controls whether users with this role can create and edit AI automations",
                "example": true,
                "type": "boolean"
              },
              "create_and_edit_ai_teammates": {
                "description": "Controls whether users with this role can create and edit AI teammates",
                "example": true,
                "type": "boolean"
              },
              "create_app_authorization": {
                "description": "Controls whether users with this role can create app authorizations",
                "example": true,
                "type": "boolean"
              },
              "create_global_custom_fields": {
                "description": "Controls whether users with this role can create global custom fields",
                "example": true,
                "type": "boolean"
              },
              "create_goal": {
                "description": "Controls whether users with this role can create goals",
                "example": true,
                "type": "boolean"
              },
              "create_pat_authorization": {
                "description": "Controls whether users with this role can create PAT authorizations",
                "example": true,
                "type": "boolean"
              },
              "create_portfolio": {
                "description": "Controls whether users with this role can create portfolios",
                "example": true,
                "type": "boolean"
              },
              "create_project": {
                "description": "Controls whether users with this role can create projects",
                "example": true,
                "type": "boolean"
              },
              "create_read_only_link": {
                "description": "Controls whether users with this role can create read-only links",
                "example": true,
                "type": "boolean"
              },
              "create_team": {
                "description": "Controls whether users with this role can create teams",
                "example": true,
                "type": "boolean"
              },
              "download_mobile_attachments": {
                "description": "Controls whether users with this role can download attachments from mobile app",
                "example": true,
                "type": "boolean"
              },
              "export_project_data": {
                "description": "Controls whether users with this role can export project data",
                "example": true,
                "type": "boolean"
              },
              "import_data": {
                "description": "Controls whether users with this role can import data into the domain",
                "example": true,
                "type": "boolean"
              },
              "manage_roles": {
                "description": "Controls whether users with this role can create, edit, and delete roles",
                "example": true,
                "type": "boolean"
              },
              "proactive_ai": {
                "description": "Controls whether users with this role can use proactive AI features",
                "example": true,
                "type": "boolean"
              },
              "share_goal_with_domain": {
                "description": "Controls whether users with this role can create company-wide goals",
                "example": true,
                "type": "boolean"
              },
              "share_portfolios_with_org": {
                "description": "Controls whether users with this role can create portfolios that are shared with the organization and share existing portfolios to the organization",
                "example": true,
                "type": "boolean"
              },
              "share_teams_with_org": {
                "description": "Controls whether users with this role can share teams with the organization",
                "example": true,
                "type": "boolean"
              },
              "standard_ai": {
                "description": "Controls whether users with this role can use standard AI features",
                "example": true,
                "type": "boolean"
              },
              "task_deletion_policy": {
                "description": "Determines what tasks users with this role are allowed to delete",
                "enum": [
                  "all",
                  "owned",
                  "none"
                ],
                "example": "all",
                "type": "string"
              },
              "upload_attachments": {
                "description": "Controls whether users with this role can upload attachments",
                "example": true,
                "type": "boolean"
              },
              "view_public_teams": {
                "description": "Controls whether users with this role can view public teams",
                "example": true,
                "type": "boolean"
              },
              "view_shared_with_org_portfolios": {
                "description": "Controls whether users with this role can view portfolios shared with the organization",
                "example": true,
                "type": "boolean"
              },
              "view_shared_with_org_projects": {
                "description": "Controls whether users with this role can view projects shared with the organization",
                "example": true,
                "type": "boolean"
              },
              "view_shared_with_org_tasks": {
                "description": "Controls whether users with this role can view tasks shared with the organization",
                "example": true,
                "type": "boolean"
              }
            },
            "type": "object"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "workspace": {
            "description": "*Create-only*. The GID of the workspace this role is associated with. Once created, roles cannot be moved to a different workspace. This attribute can only be specified at creation time.",
            "example": "12345",
            "type": "string"
          }
        },
        "required": [
          "name",
          "description",
          "base_role_type",
          "workspace"
        ],
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "role"
        }
      },
      "sdk__RbacRoleResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *role* represents a group of permissions that can be assigned to a user or team.",
        "properties": {
          "base_role_type": {
            "description": "The base role type of the role.",
            "enum": [
              "guest",
              "member",
              "admin",
              "super_admin",
              "csm"
            ],
            "type": "string"
          },
          "creation_time": {
            "description": "The time at which this role was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "description": {
            "description": "The description of the role.",
            "example": "This role has exclusive access to create app and PAT tokens.",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "is_standard_role": {
            "description": "Whether the role is a standard role or a custom role. Defaults to `false`.",
            "example": false,
            "type": "boolean"
          },
          "modified_at": {
            "description": "The time at which this role was last modified.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "name": {
            "description": "The name of the role.",
            "example": "Developer",
            "type": "string"
          },
          "permissions": {
            "description": "The permissions of the role.",
            "properties": {
              "allowed_guest_invites": {
                "description": "Controls what type of email users with this role are allowed to invite",
                "enum": [
                  "all",
                  "none"
                ],
                "example": "all",
                "type": "string"
              },
              "assign_roles": {
                "description": "Controls whether users with this role can assign guest, member, and admin roles to other users",
                "example": true,
                "type": "boolean"
              },
              "create_and_edit_ai_automations": {
                "description": "Controls whether users with this role can create and edit AI automations",
                "example": true,
                "type": "boolean"
              },
              "create_and_edit_ai_teammates": {
                "description": "Controls whether users with this role can create and edit AI teammates",
                "example": true,
                "type": "boolean"
              },
              "create_app_authorization": {
                "description": "Controls whether users with this role can create app authorizations",
                "example": true,
                "type": "boolean"
              },
              "create_global_custom_fields": {
                "description": "Controls whether users with this role can create global custom fields",
                "example": true,
                "type": "boolean"
              },
              "create_goal": {
                "description": "Controls whether users with this role can create goals",
                "example": true,
                "type": "boolean"
              },
              "create_pat_authorization": {
                "description": "Controls whether users with this role can create PAT authorizations",
                "example": true,
                "type": "boolean"
              },
              "create_portfolio": {
                "description": "Controls whether users with this role can create portfolios",
                "example": true,
                "type": "boolean"
              },
              "create_project": {
                "description": "Controls whether users with this role can create projects",
                "example": true,
                "type": "boolean"
              },
              "create_read_only_link": {
                "description": "Controls whether users with this role can create read-only links",
                "example": true,
                "type": "boolean"
              },
              "create_team": {
                "description": "Controls whether users with this role can create teams",
                "example": true,
                "type": "boolean"
              },
              "download_mobile_attachments": {
                "description": "Controls whether users with this role can download attachments from mobile app",
                "example": true,
                "type": "boolean"
              },
              "export_project_data": {
                "description": "Controls whether users with this role can export project data",
                "example": true,
                "type": "boolean"
              },
              "import_data": {
                "description": "Controls whether users with this role can import data into the domain",
                "example": true,
                "type": "boolean"
              },
              "manage_roles": {
                "description": "Controls whether users with this role can create, edit, and delete roles",
                "example": true,
                "type": "boolean"
              },
              "proactive_ai": {
                "description": "Controls whether users with this role can use proactive AI features",
                "example": true,
                "type": "boolean"
              },
              "share_goal_with_domain": {
                "description": "Controls whether users with this role can create company-wide goals",
                "example": true,
                "type": "boolean"
              },
              "share_portfolios_with_org": {
                "description": "Controls whether users with this role can create portfolios that are shared with the organization and share existing portfolios to the organization",
                "example": true,
                "type": "boolean"
              },
              "share_teams_with_org": {
                "description": "Controls whether users with this role can share teams with the organization",
                "example": true,
                "type": "boolean"
              },
              "standard_ai": {
                "description": "Controls whether users with this role can use standard AI features",
                "example": true,
                "type": "boolean"
              },
              "task_deletion_policy": {
                "description": "Determines what tasks users with this role are allowed to delete",
                "enum": [
                  "all",
                  "owned",
                  "none"
                ],
                "example": "all",
                "type": "string"
              },
              "upload_attachments": {
                "description": "Controls whether users with this role can upload attachments",
                "example": true,
                "type": "boolean"
              },
              "view_public_teams": {
                "description": "Controls whether users with this role can view public teams",
                "example": true,
                "type": "boolean"
              },
              "view_shared_with_org_portfolios": {
                "description": "Controls whether users with this role can view portfolios shared with the organization",
                "example": true,
                "type": "boolean"
              },
              "view_shared_with_org_projects": {
                "description": "Controls whether users with this role can view projects shared with the organization",
                "example": true,
                "type": "boolean"
              },
              "view_shared_with_org_tasks": {
                "description": "Controls whether users with this role can view tasks shared with the organization",
                "example": true,
                "type": "boolean"
              }
            },
            "type": "object"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "workspace": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.\n*Create-only*. The workspace this role is associated with. Once created, roles cannot be moved to a different workspace. This attribute can only be specified at creation time.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the workspace.",
                "example": "My Company Workspace",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "workspace"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "role"
        }
      },
      "sdk__RbacRoleResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__RbacRoleResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__RbacRoleResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__RbacRoleResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__RbacRoleUpdateRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *role* represents a group of permissions that can be assigned to a user or team.",
        "properties": {
          "base_role_type": {
            "description": "The base role type of the role.",
            "enum": [
              "guest",
              "member",
              "admin",
              "super_admin",
              "csm"
            ],
            "type": "string"
          },
          "creation_time": {
            "description": "The time at which this role was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "description": {
            "description": "The description of the role.",
            "example": "This role has exclusive access to create app and PAT tokens.",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "is_standard_role": {
            "description": "Whether the role is a standard role or a custom role. Defaults to `false`.",
            "example": false,
            "type": "boolean"
          },
          "modified_at": {
            "description": "The time at which this role was last modified.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "name": {
            "description": "The name of the role.",
            "example": "Developer",
            "type": "string"
          },
          "permissions": {
            "description": "The permissions of the role.",
            "properties": {
              "allowed_guest_invites": {
                "description": "Controls what type of email users with this role are allowed to invite",
                "enum": [
                  "all",
                  "none"
                ],
                "example": "all",
                "type": "string"
              },
              "assign_roles": {
                "description": "Controls whether users with this role can assign guest, member, and admin roles to other users",
                "example": true,
                "type": "boolean"
              },
              "create_and_edit_ai_automations": {
                "description": "Controls whether users with this role can create and edit AI automations",
                "example": true,
                "type": "boolean"
              },
              "create_and_edit_ai_teammates": {
                "description": "Controls whether users with this role can create and edit AI teammates",
                "example": true,
                "type": "boolean"
              },
              "create_app_authorization": {
                "description": "Controls whether users with this role can create app authorizations",
                "example": true,
                "type": "boolean"
              },
              "create_global_custom_fields": {
                "description": "Controls whether users with this role can create global custom fields",
                "example": true,
                "type": "boolean"
              },
              "create_goal": {
                "description": "Controls whether users with this role can create goals",
                "example": true,
                "type": "boolean"
              },
              "create_pat_authorization": {
                "description": "Controls whether users with this role can create PAT authorizations",
                "example": true,
                "type": "boolean"
              },
              "create_portfolio": {
                "description": "Controls whether users with this role can create portfolios",
                "example": true,
                "type": "boolean"
              },
              "create_project": {
                "description": "Controls whether users with this role can create projects",
                "example": true,
                "type": "boolean"
              },
              "create_read_only_link": {
                "description": "Controls whether users with this role can create read-only links",
                "example": true,
                "type": "boolean"
              },
              "create_team": {
                "description": "Controls whether users with this role can create teams",
                "example": true,
                "type": "boolean"
              },
              "download_mobile_attachments": {
                "description": "Controls whether users with this role can download attachments from mobile app",
                "example": true,
                "type": "boolean"
              },
              "export_project_data": {
                "description": "Controls whether users with this role can export project data",
                "example": true,
                "type": "boolean"
              },
              "import_data": {
                "description": "Controls whether users with this role can import data into the domain",
                "example": true,
                "type": "boolean"
              },
              "manage_roles": {
                "description": "Controls whether users with this role can create, edit, and delete roles",
                "example": true,
                "type": "boolean"
              },
              "proactive_ai": {
                "description": "Controls whether users with this role can use proactive AI features",
                "example": true,
                "type": "boolean"
              },
              "share_goal_with_domain": {
                "description": "Controls whether users with this role can create company-wide goals",
                "example": true,
                "type": "boolean"
              },
              "share_portfolios_with_org": {
                "description": "Controls whether users with this role can create portfolios that are shared with the organization and share existing portfolios to the organization",
                "example": true,
                "type": "boolean"
              },
              "share_teams_with_org": {
                "description": "Controls whether users with this role can share teams with the organization",
                "example": true,
                "type": "boolean"
              },
              "standard_ai": {
                "description": "Controls whether users with this role can use standard AI features",
                "example": true,
                "type": "boolean"
              },
              "task_deletion_policy": {
                "description": "Determines what tasks users with this role are allowed to delete",
                "enum": [
                  "all",
                  "owned",
                  "none"
                ],
                "example": "all",
                "type": "string"
              },
              "upload_attachments": {
                "description": "Controls whether users with this role can upload attachments",
                "example": true,
                "type": "boolean"
              },
              "view_public_teams": {
                "description": "Controls whether users with this role can view public teams",
                "example": true,
                "type": "boolean"
              },
              "view_shared_with_org_portfolios": {
                "description": "Controls whether users with this role can view portfolios shared with the organization",
                "example": true,
                "type": "boolean"
              },
              "view_shared_with_org_projects": {
                "description": "Controls whether users with this role can view projects shared with the organization",
                "example": true,
                "type": "boolean"
              },
              "view_shared_with_org_tasks": {
                "description": "Controls whether users with this role can view tasks shared with the organization",
                "example": true,
                "type": "boolean"
              }
            },
            "type": "object"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "role"
        }
      },
      "sdk__ReactionCompact": {
        "description": "An emoji reaction on an object.",
        "properties": {
          "emoji": {
            "description": "The emoji string used in the reaction.",
            "example": "👍",
            "type": "string"
          },
          "gid": {
            "description": "The ID of the reaction object.",
            "example": "12345",
            "type": "string"
          },
          "user": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          }
        },
        "type": "object"
      },
      "sdk__ReactionCompactArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__ReactionCompact"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__ReactionSummaryItemCompact": {
        "description": "A summary of an emoji reaction on an object.",
        "properties": {
          "count": {
            "description": "The number of reactions with the emoji variant on the object.",
            "example": 1,
            "type": "number"
          },
          "emoji_base": {
            "description": "The emoji base character used in the reaction.",
            "example": "👎",
            "type": "string"
          },
          "reacted": {
            "description": "Whether the current user has reacted with the emoji variant on the object.",
            "example": false,
            "type": "boolean"
          },
          "variant": {
            "description": "The full emoji string used in the reaction.",
            "example": "👎🏼",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__RecordItemBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *record* is a single row in a table. Fields on a record are backed by the table's custom field settings.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the record.",
            "example": "Q3 renewal",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "record"
        }
      },
      "sdk__RecordItemCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *record* is a single row in a table. Fields on a record are backed by the table's custom field settings.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the record.",
            "example": "Q3 renewal",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "record"
        }
      },
      "sdk__RecordItemRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *record* is a single row in a table. Fields on a record are backed by the table's custom field settings.",
        "properties": {
          "custom_fields": {
            "additionalProperties": {
              "description": "\"{custom_field_gid}\" => Value (can be text, enum GID, a number, etc.). For date, use format \"YYYY-MM-DD\" (e.g., 2019-09-15). For date-time, use ISO 8601 date string in UTC (e.g., 2019-09-15T02:06:58.147Z).",
              "type": "string"
            },
            "description": "An object where each key is the GID of a custom field and its corresponding value is either an enum GID, string, number, or object (depending on the custom field type). See the [custom fields guide](/docs/custom-fields-guide) for details on creating and updating custom field values. Only fields already associated with the record's table (i.e. already present in the table's custom field settings) can be written this way; unlike tasks and projects, records do not support force-writing a value for a custom field that is not yet on the table.",
            "example": {
              "4578152156": "Not Started",
              "5678904321": "On Hold"
            },
            "type": "object"
          },
          "default_access_level": {
            "description": "The default access level for users who join or are added as members of the record. This isn't applied when the record is private.",
            "enum": [
              "admin",
              "editor",
              "commenter",
              "viewer"
            ],
            "example": "viewer",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the record.",
            "example": "Q3 renewal",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "table": {
            "description": "The table in which this record will be created.",
            "example": "1337",
            "type": "string"
          },
          "unique_fingerprint": {
            "description": "An optional client-provided identifier used to deduplicate record creation within a table. If a record already exists in the table with the same `unique_fingerprint`, the request fails with a `409 Conflict` error rather than creating a duplicate.",
            "example": "sfdc-opportunity-0061",
            "type": "string"
          }
        },
        "required": [
          "name",
          "table"
        ],
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "record"
        }
      },
      "sdk__RecordItemResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *record* is a single row in a table. Fields on a record are backed by the table's custom field settings.",
        "properties": {
          "comment_count": {
            "description": "The number of comments on the record.",
            "example": 3,
            "readOnly": true,
            "type": "integer"
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "created_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "custom_fields": {
            "description": "Array of custom field values applied to the record.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.",
              "properties": {
                "asana_created_field": {
                  "description": "*Conditional*. A unique identifier to associate this field with the template source of truth.",
                  "enum": [
                    "a_v_requirements",
                    "account_name",
                    "actionable",
                    "align_shipping_link",
                    "align_status",
                    "allotted_time",
                    "appointment",
                    "approval_stage",
                    "approved",
                    "article_series",
                    "board_committee",
                    "browser",
                    "campaign_audience",
                    "campaign_project_status",
                    "campaign_regions",
                    "channel_primary",
                    "client_topic_type",
                    "complete_by",
                    "contact",
                    "contact_email_address",
                    "content_channels",
                    "content_channels_needed",
                    "content_stage",
                    "content_type",
                    "contract",
                    "contract_status",
                    "cost",
                    "creation_stage",
                    "creative_channel",
                    "creative_needed",
                    "creative_needs",
                    "data_sensitivity",
                    "deal_size",
                    "delivery_appt",
                    "delivery_appt_date",
                    "department",
                    "department_responsible",
                    "design_request_needed",
                    "design_request_type",
                    "discussion_category",
                    "do_this_task",
                    "editorial_content_status",
                    "editorial_content_tag",
                    "editorial_content_type",
                    "effort",
                    "effort_level",
                    "est_completion_date",
                    "estimated_time",
                    "estimated_value",
                    "expected_cost",
                    "external_steps_needed",
                    "favorite_idea",
                    "feedback_type",
                    "financial",
                    "funding_amount",
                    "grant_application_process",
                    "hiring_candidate_status",
                    "idea_status",
                    "ids_link",
                    "ids_patient_link",
                    "implementation_stage",
                    "insurance",
                    "interview_area",
                    "interview_question_score",
                    "itero_scan_link",
                    "job_s_applied_to",
                    "lab",
                    "launch_status",
                    "lead_status",
                    "localization_language",
                    "localization_market_team",
                    "localization_status",
                    "meeting_minutes",
                    "meeting_needed",
                    "minutes",
                    "mrr",
                    "must_localize",
                    "name_of_foundation",
                    "need_to_follow_up",
                    "next_appointment",
                    "next_steps_sales",
                    "num_people",
                    "number_of_user_reports",
                    "office_location",
                    "onboarding_activity",
                    "owner",
                    "participants_needed",
                    "patient_date_of_birth",
                    "patient_email",
                    "patient_phone",
                    "patient_status",
                    "phone_number",
                    "planning_category",
                    "point_of_contact",
                    "position",
                    "post_format",
                    "prescription",
                    "priority",
                    "priority_level",
                    "product",
                    "product_stage",
                    "progress",
                    "project_size",
                    "project_status",
                    "proposed_budget",
                    "publish_status",
                    "reason_for_scan",
                    "referral",
                    "request_type",
                    "research_status",
                    "responsible_department",
                    "responsible_team",
                    "risk_assessment_status",
                    "room_name",
                    "sales_counterpart",
                    "sentiment",
                    "shipping_link",
                    "social_channels",
                    "stage",
                    "status",
                    "status_design",
                    "status_of_initiative",
                    "system_setup",
                    "task_progress",
                    "team",
                    "team_marketing",
                    "team_responsible",
                    "time_it_takes_to_complete_tasks",
                    "timeframe",
                    "treatment_type",
                    "type_work_requests_it",
                    "use_agency",
                    "user_name",
                    "vendor_category",
                    "vendor_type",
                    "word_count",
                    null
                  ],
                  "example": "priority",
                  "nullable": true,
                  "readOnly": true,
                  "type": "string"
                },
                "created_by": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                  "nullable": true,
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "*Read-only except when same user as requester*. The user's name.",
                      "example": "Greg Sanchez",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "user"
                  }
                },
                "currency_code": {
                  "description": "ISO 4217 currency code to format this custom field. This will be null if the `format` is not `currency`.",
                  "example": "EUR",
                  "nullable": true,
                  "type": "string"
                },
                "custom_label": {
                  "description": "This is the string that appears next to the custom field value. This will be null if the `format` is not `custom`.",
                  "example": "gold pieces",
                  "nullable": true,
                  "type": "string"
                },
                "custom_label_position": {
                  "description": "Only relevant for custom fields with `custom` format. This depicts where to place the custom label. This will be null if the `format` is not `custom`.",
                  "enum": [
                    "prefix",
                    "suffix",
                    null
                  ],
                  "example": "suffix",
                  "nullable": true,
                  "type": "string"
                },
                "date_value": {
                  "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                  "nullable": true,
                  "properties": {
                    "date": {
                      "description": "A string representing the date in YYYY-MM-DD format.",
                      "example": "2024-08-23",
                      "type": "string"
                    },
                    "date_time": {
                      "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                      "example": "2024-08-23T22:00:00.000Z",
                      "type": "string"
                    }
                  },
                  "type": "object"
                },
                "default_access_level": {
                  "description": "The default access level when inviting new members to the custom field. This isn't applied when the `privacy_setting` is `private`, or the user is a guest. For local fields in a project or portfolio, the user must additionally have permission to modify the container itself.",
                  "enum": [
                    "admin",
                    "editor",
                    "user"
                  ],
                  "example": "user",
                  "type": "string"
                },
                "description": {
                  "description": "[Opt In](/docs/inputoutput-options). The description of the custom field.",
                  "example": "Development team priority",
                  "type": "string"
                },
                "display_value": {
                  "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                  "example": "blue",
                  "nullable": true,
                  "readOnly": true,
                  "type": "string"
                },
                "enabled": {
                  "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                  "example": true,
                  "readOnly": true,
                  "type": "boolean"
                },
                "enum_options": {
                  "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                  "items": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                    "properties": {
                      "color": {
                        "description": "The color of the enum option. Defaults to `none`.",
                        "example": "blue",
                        "type": "string"
                      },
                      "enabled": {
                        "description": "Whether or not the enum option is a selectable value for the custom field.",
                        "example": true,
                        "type": "boolean"
                      },
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "The name of the enum option.",
                        "example": "Low",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "enum_option"
                    }
                  },
                  "type": "array"
                },
                "enum_value": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                  "nullable": true,
                  "properties": {
                    "color": {
                      "description": "The color of the enum option. Defaults to `none`.",
                      "example": "blue",
                      "type": "string"
                    },
                    "enabled": {
                      "description": "Whether or not the enum option is a selectable value for the custom field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the enum option.",
                      "example": "Low",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "enum_option"
                  }
                },
                "format": {
                  "description": "The format of this custom field.",
                  "enum": [
                    "currency",
                    "identifier",
                    "percentage",
                    "custom",
                    "duration",
                    "none"
                  ],
                  "example": "custom",
                  "type": "string"
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "has_notifications_enabled": {
                  "description": "*Conditional*. This flag describes whether a follower of a task with this field should receive inbox notifications from changes to this field.",
                  "example": true,
                  "type": "boolean"
                },
                "html_text_value": {
                  "description": "*Conditional*. Only relevant for custom fields of type `text`. This is the HTML representation of the text value of a custom field, corresponding to the `text_value` plain-text field. See [rich text](/docs/rich-text#reading-rich-text).",
                  "example": "<body>Some Value</body>",
                  "nullable": true,
                  "readOnly": true,
                  "type": "string"
                },
                "id_prefix": {
                  "description": "This field is the unique custom ID string for the custom field.",
                  "example": "ID",
                  "nullable": true,
                  "type": "string"
                },
                "input_restrictions": {
                  "example": [
                    "task"
                  ],
                  "items": {
                    "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                    "enum": [
                      "task",
                      "project",
                      "portfolio",
                      "goal"
                    ],
                    "type": "string"
                  },
                  "type": "array"
                },
                "is_formula_field": {
                  "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                  "example": false,
                  "type": "boolean"
                },
                "is_global_to_workspace": {
                  "description": "This flag describes whether this custom field is available to every container in the workspace. Before project-specific custom fields, this field was always true.",
                  "example": true,
                  "readOnly": true,
                  "type": "boolean"
                },
                "is_lookup_field": {
                  "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                  "example": false,
                  "type": "boolean"
                },
                "is_value_read_only": {
                  "description": "*Conditional*. This flag describes whether a custom field is read only.",
                  "example": false,
                  "type": "boolean"
                },
                "multi_enum_values": {
                  "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                  "items": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                    "properties": {
                      "color": {
                        "description": "The color of the enum option. Defaults to `none`.",
                        "example": "blue",
                        "type": "string"
                      },
                      "enabled": {
                        "description": "Whether or not the enum option is a selectable value for the custom field.",
                        "example": true,
                        "type": "boolean"
                      },
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "The name of the enum option.",
                        "example": "Low",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "enum_option"
                    }
                  },
                  "type": "array"
                },
                "name": {
                  "description": "The name of the custom field.",
                  "example": "Status",
                  "type": "string"
                },
                "number_value": {
                  "description": "*Conditional*. This number is the value of a `number` custom field.",
                  "example": 5.2,
                  "nullable": true,
                  "type": "number"
                },
                "people_value": {
                  "description": "*Conditional*. Only relevant for custom fields of type `people`. This array of [compact user](/reference/users) objects reflects the values of a `people` custom field.",
                  "items": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                    "properties": {
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "*Read-only except when same user as requester*. The user's name.",
                        "example": "Greg Sanchez",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "user"
                    }
                  },
                  "type": "array"
                },
                "precision": {
                  "description": "Only relevant for custom fields of type `Number`. This field dictates the number of places after the decimal to round to, i.e. 0 is integer values, 1 rounds to the nearest tenth, and so on. Must be between 0 and 6, inclusive.\nFor percentage format, this may be unintuitive, as a value of 0.25 has a precision of 0, while a value of 0.251 has a precision of 1. This is due to 0.25 being displayed as 25%.\nThe identifier format will always have a precision of 0.",
                  "example": 2,
                  "type": "integer"
                },
                "privacy_setting": {
                  "description": "The privacy setting of the custom field. *Note: Administrators in your organization may restrict the values of `privacy_setting`.*",
                  "enum": [
                    "public_with_guests",
                    "public",
                    "private"
                  ],
                  "example": "public_with_guests",
                  "type": "string"
                },
                "reference_value": {
                  "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of objects reflects the values of a `reference` custom field.",
                  "items": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.",
                    "properties": {
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "The name of the object.",
                        "example": "Bug Task",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object"
                  },
                  "type": "array"
                },
                "representation_type": {
                  "description": "This field tells the type of the custom field.",
                  "enum": [
                    "text",
                    "enum",
                    "multi_enum",
                    "number",
                    "date",
                    "people",
                    "formula",
                    "custom_id",
                    "reference"
                  ],
                  "example": "number",
                  "readOnly": true,
                  "type": "string"
                },
                "resource_subtype": {
                  "description": "The type of the custom field. Must be one of the given values.\n",
                  "enum": [
                    "text",
                    "enum",
                    "multi_enum",
                    "number",
                    "date",
                    "people",
                    "reference"
                  ],
                  "example": "text",
                  "readOnly": true,
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                },
                "text_value": {
                  "description": "*Conditional*. This string is the value of a `text` custom field.",
                  "example": "Some Value",
                  "nullable": true,
                  "type": "string"
                },
                "type": {
                  "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                  "enum": [
                    "text",
                    "enum",
                    "multi_enum",
                    "number",
                    "date",
                    "people",
                    "reference"
                  ],
                  "readOnly": true,
                  "type": "string"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "custom_field"
              }
            },
            "type": "array"
          },
          "default_access_level": {
            "description": "The default access level for users who join or are added as members of the record. This isn't applied when the record is private.",
            "enum": [
              "admin",
              "editor",
              "commenter",
              "viewer"
            ],
            "example": "viewer",
            "type": "string"
          },
          "deleted_at": {
            "description": "The time at which this resource was deleted, or null if it has not been deleted.",
            "format": "date-time",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "is_in_archived_table": {
            "description": "True if the record's table is archived, false if not.",
            "example": false,
            "readOnly": true,
            "type": "boolean"
          },
          "modified_at": {
            "description": "The time at which this record was last modified.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "name": {
            "description": "The name of the record.",
            "example": "Q3 renewal",
            "type": "string"
          },
          "permalink_url": {
            "description": "A url that points directly to the object within Asana.",
            "example": "https://app.asana.com/0/resource/123",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "table": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *table* is a container for structured records (rows), with columns defined by custom field settings.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *table* is a container for structured records (rows), with columns defined by custom field settings.\nThe table that this record belongs to. Omitted if you don't have access to the table, or null if the record has no associated table.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the table.",
                "example": "Vendor contracts",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "table"
            }
          },
          "workspace": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.\nThe workspace this record belongs to.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the workspace.",
                "example": "My Company Workspace",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "workspace"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "record"
        }
      },
      "sdk__RecordItemResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__RecordItemResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__RecordItemResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__RecordItemResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__RecordItemUpdateRequest": {
        "properties": {
          "custom_fields": {
            "additionalProperties": {
              "description": "\"{custom_field_gid}\" => Value (can be text, enum GID, a number, etc.). For date, use format \"YYYY-MM-DD\" (e.g., 2019-09-15). For date-time, use ISO 8601 date string in UTC (e.g., 2019-09-15T02:06:58.147Z).",
              "type": "string"
            },
            "description": "An object where each key is the GID of a custom field and its corresponding value is either an enum GID, string, number, or object (depending on the custom field type). See the [custom fields guide](/docs/custom-fields-guide) for details on creating and updating custom field values. Only fields already associated with the record's table (i.e. already present in the table's custom field settings) can be written this way; unlike tasks and projects, records do not support force-writing a value for a custom field that is not yet on the table.",
            "type": "object"
          },
          "default_access_level": {
            "description": "The default access level for users who join or are added as members of the record. This isn't applied when the record is private.",
            "enum": [
              "admin",
              "editor",
              "commenter",
              "viewer"
            ],
            "example": "viewer",
            "type": "string"
          },
          "name": {
            "description": "The name of the record.",
            "example": "Q3 renewal",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__RecordMembershipCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA user or team's membership in a record.",
        "properties": {
          "access_level": {
            "description": "The member's access level in the record.",
            "enum": [
              "admin",
              "editor",
              "commenter",
              "viewer"
            ],
            "example": "viewer",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the member",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of the member (team or user)",
                "example": "user",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "member"
            }
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *record* is a single row in a table. Fields on a record are backed by the table's custom field settings.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the record.",
                "example": "Q3 renewal",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "record"
            }
          },
          "resource_subtype": {
            "description": "Type of the membership.",
            "example": "record_membership",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "membership"
        }
      },
      "sdk__RecordMembershipResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA user or team's membership in a record.",
        "properties": {
          "access_level": {
            "description": "The member's access level in the record.",
            "enum": [
              "admin",
              "editor",
              "commenter",
              "viewer"
            ],
            "example": "viewer",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the member",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of the member (team or user)",
                "example": "user",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "member"
            }
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *record* is a single row in a table. Fields on a record are backed by the table's custom field settings.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the record.",
                "example": "Q3 renewal",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "record"
            }
          },
          "resource_subtype": {
            "description": "Type of the membership.",
            "example": "record_membership",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "membership"
        }
      },
      "sdk__RemoveCustomFieldSettingRequest": {
        "properties": {
          "custom_field": {
            "description": "The custom field to remove from this portfolio.",
            "example": "14916",
            "type": "string"
          }
        },
        "required": [
          "custom_field"
        ],
        "type": "object"
      },
      "sdk__RemoveFollowersRequest": {
        "properties": {
          "followers": {
            "description": "An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user.",
            "example": "521621,621373",
            "type": "string"
          }
        },
        "required": [
          "followers"
        ],
        "type": "object"
      },
      "sdk__RemoveMembersRequest": {
        "properties": {
          "members": {
            "description": "An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user.",
            "example": "521621,621373",
            "type": "string"
          }
        },
        "required": [
          "members"
        ],
        "type": "object"
      },
      "sdk__RequestedRoleRequest": {
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the template role in the project template.",
            "example": "1",
            "type": "string"
          },
          "value": {
            "description": "A string identifying a user that should be assigned to the template role. This can either be the string \"me\", an email, or the gid of a user.",
            "example": "123",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__ResourceExportCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *resource_export* object represents a request to bulk export objects for one or more resources.",
        "properties": {
          "completed_at": {
            "description": "The time at which this resource was completed. This will be null if the export is still in progress.",
            "example": "2012-02-22T03:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "created_at": {
            "description": "The time at which the resource export object was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "download_url": {
            "description": "Download this URL to retrieve the full export\nin [JSON Lines](https://jsonlines.org/) format. It will be compressed in a gzip (.gz) container.\n\n*Note: May be null if the export is still in progress or failed.*",
            "example": "https://asana-export-us-east-1.s3.us-east-1.amazonaws.com/2563645399633793/object_export/7588024658887731/download/ object_export_2563645399633793_7588024658887731_2023018-201726.jsonl.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256& X-Amz-Credential=xxxxxxxx&X-Amz-Date=xxxxxxxx&X-Amz-Expires=300&X-Amz-Security-Token=xxxxxxxx& X-Amz-Signature=xxxxxxxx&X-Amz-SignedHeaders=host",
            "format": "uri",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "export_request"
        }
      },
      "sdk__ResourceExportFilters": {
        "description": "Filters to apply to a resource that will be exported. These filters can be used to narrow down the resources that are included in the export.",
        "properties": {
          "assigned_by.any": {
            "description": "Filter by the users who assigned the resource. This array accepts a list of user GIDs. This is only applicable to tasks.",
            "items": {
              "example": "12345",
              "type": "string"
            },
            "type": "array"
          },
          "assignee.any": {
            "description": "Filter by the users who are assigned to the resource. This array accepts a list of user GIDs. This is only applicable to tasks.",
            "items": {
              "example": "12345",
              "type": "string"
            },
            "type": "array"
          },
          "commented_on_by.any": {
            "description": "Filter by the users who commented on the resource. This array accepts a list of user GIDs.",
            "items": {
              "example": "12345",
              "type": "string"
            },
            "type": "array"
          },
          "created_at.after": {
            "description": "Filter results to resources created after a specified date and time.",
            "example": "2023-01-01T00:00:00Z",
            "format": "date-time",
            "type": "string"
          },
          "created_at.before": {
            "description": "Filter results to resources created before a specified date and time.",
            "example": "2023-01-01T00:00:00Z",
            "format": "date-time",
            "type": "string"
          },
          "created_by.any": {
            "description": "Filter by the users who created the resource. This array accepts a list of user GIDs.",
            "items": {
              "example": "12345",
              "type": "string"
            },
            "type": "array"
          },
          "followers.any": {
            "description": "Filter by the users who are following the resource. This array accepts a list of user GIDs.",
            "items": {
              "example": "12345",
              "type": "string"
            },
            "type": "array"
          },
          "liked_by.any": {
            "description": "Filter by the users who liked the resource. This array accepts a list of user GIDs.",
            "items": {
              "example": "12345",
              "type": "string"
            },
            "type": "array"
          },
          "modified_at.after": {
            "description": "Filter results to resources modified after a specified date and time.",
            "example": "2023-01-01T00:00:00Z",
            "format": "date-time",
            "type": "string"
          },
          "modified_at.before": {
            "description": "Filter results to resources modified before a specified date and time.",
            "example": "2023-01-01T00:00:00Z",
            "format": "date-time",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__ResourceExportRequest": {
        "description": "A *resource_export* request starts a job to bulk export objects for one or more resources.",
        "properties": {
          "export_request_parameters": {
            "description": "An object containing the parameters for the export request. The keys of this object are the GIDs of the resources to be exported. The values are objects with additional parameters for each resource.",
            "items": {
              "properties": {
                "fields": {
                  "description": "An array of fields to include for the resource type. If not provided, all non-optional fields for the resource type will be included. This conforms to the fields optional parameter available for all Asana endpoints which is documented [here](https://developers.asana.com/docs/inputoutput-options)",
                  "items": {
                    "example": "gid",
                    "type": "string"
                  },
                  "type": "array"
                },
                "filters": {
                  "description": "Filters to apply to a resource that will be exported. These filters can be used to narrow down the resources that are included in the export.",
                  "properties": {
                    "assigned_by.any": {
                      "description": "Filter by the users who assigned the resource. This array accepts a list of user GIDs. This is only applicable to tasks.",
                      "items": {
                        "example": "12345",
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "assignee.any": {
                      "description": "Filter by the users who are assigned to the resource. This array accepts a list of user GIDs. This is only applicable to tasks.",
                      "items": {
                        "example": "12345",
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "commented_on_by.any": {
                      "description": "Filter by the users who commented on the resource. This array accepts a list of user GIDs.",
                      "items": {
                        "example": "12345",
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "created_at.after": {
                      "description": "Filter results to resources created after a specified date and time.",
                      "example": "2023-01-01T00:00:00Z",
                      "format": "date-time",
                      "type": "string"
                    },
                    "created_at.before": {
                      "description": "Filter results to resources created before a specified date and time.",
                      "example": "2023-01-01T00:00:00Z",
                      "format": "date-time",
                      "type": "string"
                    },
                    "created_by.any": {
                      "description": "Filter by the users who created the resource. This array accepts a list of user GIDs.",
                      "items": {
                        "example": "12345",
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "followers.any": {
                      "description": "Filter by the users who are following the resource. This array accepts a list of user GIDs.",
                      "items": {
                        "example": "12345",
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "liked_by.any": {
                      "description": "Filter by the users who liked the resource. This array accepts a list of user GIDs.",
                      "items": {
                        "example": "12345",
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "modified_at.after": {
                      "description": "Filter results to resources modified after a specified date and time.",
                      "example": "2023-01-01T00:00:00Z",
                      "format": "date-time",
                      "type": "string"
                    },
                    "modified_at.before": {
                      "description": "Filter results to resources modified before a specified date and time.",
                      "example": "2023-01-01T00:00:00Z",
                      "format": "date-time",
                      "type": "string"
                    }
                  },
                  "type": "object"
                },
                "resource_type": {
                  "description": "The type of the resource to be exported. This can be a task, team, or message.",
                  "example": "task",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "workspace": {
            "description": "Gid of a workspace.",
            "example": "12345",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__ResourceExportRequestParameter": {
        "properties": {
          "fields": {
            "description": "An array of fields to include for the resource type. If not provided, all non-optional fields for the resource type will be included. This conforms to the fields optional parameter available for all Asana endpoints which is documented [here](https://developers.asana.com/docs/inputoutput-options)",
            "items": {
              "example": "gid",
              "type": "string"
            },
            "type": "array"
          },
          "filters": {
            "description": "Filters to apply to a resource that will be exported. These filters can be used to narrow down the resources that are included in the export.",
            "properties": {
              "assigned_by.any": {
                "description": "Filter by the users who assigned the resource. This array accepts a list of user GIDs. This is only applicable to tasks.",
                "items": {
                  "example": "12345",
                  "type": "string"
                },
                "type": "array"
              },
              "assignee.any": {
                "description": "Filter by the users who are assigned to the resource. This array accepts a list of user GIDs. This is only applicable to tasks.",
                "items": {
                  "example": "12345",
                  "type": "string"
                },
                "type": "array"
              },
              "commented_on_by.any": {
                "description": "Filter by the users who commented on the resource. This array accepts a list of user GIDs.",
                "items": {
                  "example": "12345",
                  "type": "string"
                },
                "type": "array"
              },
              "created_at.after": {
                "description": "Filter results to resources created after a specified date and time.",
                "example": "2023-01-01T00:00:00Z",
                "format": "date-time",
                "type": "string"
              },
              "created_at.before": {
                "description": "Filter results to resources created before a specified date and time.",
                "example": "2023-01-01T00:00:00Z",
                "format": "date-time",
                "type": "string"
              },
              "created_by.any": {
                "description": "Filter by the users who created the resource. This array accepts a list of user GIDs.",
                "items": {
                  "example": "12345",
                  "type": "string"
                },
                "type": "array"
              },
              "followers.any": {
                "description": "Filter by the users who are following the resource. This array accepts a list of user GIDs.",
                "items": {
                  "example": "12345",
                  "type": "string"
                },
                "type": "array"
              },
              "liked_by.any": {
                "description": "Filter by the users who liked the resource. This array accepts a list of user GIDs.",
                "items": {
                  "example": "12345",
                  "type": "string"
                },
                "type": "array"
              },
              "modified_at.after": {
                "description": "Filter results to resources modified after a specified date and time.",
                "example": "2023-01-01T00:00:00Z",
                "format": "date-time",
                "type": "string"
              },
              "modified_at.before": {
                "description": "Filter results to resources modified before a specified date and time.",
                "example": "2023-01-01T00:00:00Z",
                "format": "date-time",
                "type": "string"
              }
            },
            "type": "object"
          },
          "resource_type": {
            "description": "The type of the resource to be exported. This can be a task, team, or message.",
            "example": "task",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__ResourceExportResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "new_resource_export": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *resource_export* object represents a request to bulk export objects for one or more resources.",
            "properties": {
              "completed_at": {
                "description": "The time at which this resource was completed. This will be null if the export is still in progress.",
                "example": "2012-02-22T03:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "created_at": {
                "description": "The time at which the resource export object was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "download_url": {
                "description": "Download this URL to retrieve the full export\nin [JSON Lines](https://jsonlines.org/) format. It will be compressed in a gzip (.gz) container.\n\n*Note: May be null if the export is still in progress or failed.*",
                "example": "https://asana-export-us-east-1.s3.us-east-1.amazonaws.com/2563645399633793/object_export/7588024658887731/download/ object_export_2563645399633793_7588024658887731_2023018-201726.jsonl.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256& X-Amz-Credential=xxxxxxxx&X-Amz-Date=xxxxxxxx&X-Amz-Expires=300&X-Amz-Security-Token=xxxxxxxx& X-Amz-Signature=xxxxxxxx&X-Amz-SignedHeaders=host",
                "format": "uri",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "export_request"
            }
          },
          "resource_subtype": {
            "description": "A *resource_export* object represents a request to bulk export objects for one or more resources.",
            "example": "export_request",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "status": {
            "description": "The current status of this job.",
            "enum": [
              "not_started",
              "in_progress",
              "succeeded",
              "failed"
            ],
            "example": "succeeded",
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "job"
        }
      },
      "sdk__ResourceExportResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__ResourceExportResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__RuleTriggerRequest": {
        "properties": {
          "action_data": {
            "additionalProperties": true,
            "description": "The dynamic keys and values of the request. These fields are intended to be used in the action for the rule associated with this trigger.",
            "example": {
              "jira_ticket_id": "123",
              "jira_ticket_name": "Test"
            },
            "type": "object"
          },
          "resource": {
            "description": "The ID of the resource. For the duration of the beta, this resource is always a task, and this task must exist in the project in which the rule is created.",
            "example": "12345",
            "type": "string"
          }
        },
        "required": [
          "resource",
          "action_data"
        ],
        "type": "object"
      },
      "sdk__RuleTriggerResponse": {
        "properties": {
          "message": {
            "description": "Message providing more detail about the result",
            "example": "Successfully saved the payload and ran the rule",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__RuleTriggerResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__RuleTriggerResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__SectionBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *section* is a subdivision of a project that groups tasks together. It can either be a header above a list of tasks in a list view or a column in a board view of a project.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the section (i.e. the text displayed as the section header).",
            "example": "Next Actions",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "section"
        }
      },
      "sdk__SectionCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *section* is a subdivision of a project that groups tasks together. It can either be a header above a list of tasks in a list view or a column in a board view of a project.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the section (i.e. the text displayed as the section header).",
            "example": "Next Actions",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "section"
        }
      },
      "sdk__SectionRequest": {
        "properties": {
          "insert_after": {
            "description": "An existing section within this project after which the added section should be inserted. Cannot be provided together with insert_before.",
            "example": "987654",
            "type": "string"
          },
          "insert_before": {
            "description": "An existing section within this project before which the added section should be inserted. Cannot be provided together with insert_after.",
            "example": "86420",
            "type": "string"
          },
          "name": {
            "description": "The text to be displayed as the section name. This cannot be an empty string.",
            "example": "Next Actions",
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "sdk__SectionResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *section* is a subdivision of a project that groups tasks together. It can either be a header above a list of tasks in a list view or a column in a board view of a project.",
        "properties": {
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the section (i.e. the text displayed as the section header).",
            "example": "Next Actions",
            "type": "string"
          },
          "project": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          "projects": {
            "description": "*Deprecated - please use project instead*",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "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.",
                  "example": "Stuff to buy",
                  "type": "string"
                },
                "resource_subtype": {
                  "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                  "enum": [
                    "default_project",
                    "custom"
                  ],
                  "example": "default_project",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "project"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "section"
        }
      },
      "sdk__SectionResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__SectionResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__SectionResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__SectionResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__SectionTaskInsertRequest": {
        "properties": {
          "insert_after": {
            "description": "An existing task within this section after which the added task should be inserted. Cannot be provided together with insert_before.",
            "example": "987654",
            "type": "string"
          },
          "insert_before": {
            "description": "An existing task within this section before which the added task should be inserted. Cannot be provided together with insert_after.",
            "example": "86420",
            "type": "string"
          },
          "task": {
            "description": "The task to add to this section.",
            "example": "123456",
            "type": "string"
          }
        },
        "required": [
          "task"
        ],
        "type": "object"
      },
      "sdk__StatusUpdateBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *status update* is an update on the progress of a particular project, portfolio, or goal, and is sent out to all of its parent's followers when created. These updates include both text describing the update and a `status_type` intended to represent the overall state of the object.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_text": {
            "description": "[Opt In](/docs/inputoutput-options). The text content of the status update with formatting as HTML. See [rich text](/docs/rich-text).",
            "example": "<body>The project <strong>is</strong> moving forward according to plan...</body>",
            "type": "string"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe `resource_subtype`s for `status` objects represent the type of their parent.",
            "enum": [
              "project_status_update",
              "portfolio_status_update",
              "goal_status_update"
            ],
            "example": "project_status_update",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "status_type": {
            "description": "The type associated with the status update. This represents the current state of the object this object is on.\n\nThe valid values for `status_type` depend on the parent of the status update:\n- Projects: `on_track`, `at_risk`, `off_track`, `on_hold`, `complete`, `dropped`.\n- Portfolios: `on_track`, `at_risk`, `off_track`, `on_hold`, `complete`, `dropped`.\n- Goals: `on_track`, `at_risk`, `off_track`, `achieved`, `partial`, `missed`, `dropped`.",
            "enum": [
              "on_track",
              "at_risk",
              "off_track",
              "on_hold",
              "complete",
              "achieved",
              "partial",
              "missed",
              "dropped"
            ],
            "type": "string"
          },
          "text": {
            "description": "The text content of the status update.",
            "example": "The project is moving forward according to plan...",
            "type": "string"
          },
          "title": {
            "description": "The title of the status update.",
            "example": "Status Update - Jun 15",
            "type": "string"
          }
        },
        "required": [
          "text",
          "status_type"
        ],
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "status_update"
        }
      },
      "sdk__StatusUpdateCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *status update* is an update on the progress of a particular project, portfolio, or goal, and is sent out to all of its parent's followers when created. These updates include both text describing the update and a `status_type` intended to represent the overall state of the object.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe `resource_subtype`s for `status` objects represent the type of their parent.",
            "enum": [
              "project_status_update",
              "portfolio_status_update",
              "goal_status_update"
            ],
            "example": "project_status_update",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "title": {
            "description": "The title of the status update.",
            "example": "Status Update - Jun 15",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "status_update"
        }
      },
      "sdk__StatusUpdateRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *status update* is an update on the progress of a particular project, portfolio, or goal, and is sent out to all of its parent's followers when created. These updates include both text describing the update and a `status_type` intended to represent the overall state of the object.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_text": {
            "description": "[Opt In](/docs/inputoutput-options). The text content of the status update with formatting as HTML. See [rich text](/docs/rich-text).",
            "example": "<body>The project <strong>is</strong> moving forward according to plan...</body>",
            "type": "string"
          },
          "parent": {
            "description": "The id of parent to send this status update to. This can be a project, goal or portfolio.",
            "type": "string"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe `resource_subtype`s for `status` objects represent the type of their parent.",
            "enum": [
              "project_status_update",
              "portfolio_status_update",
              "goal_status_update"
            ],
            "example": "project_status_update",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "status_type": {
            "description": "The type associated with the status update. This represents the current state of the object this object is on.\n\nThe valid values for `status_type` depend on the parent of the status update:\n- Projects: `on_track`, `at_risk`, `off_track`, `on_hold`, `complete`, `dropped`.\n- Portfolios: `on_track`, `at_risk`, `off_track`, `on_hold`, `complete`, `dropped`.\n- Goals: `on_track`, `at_risk`, `off_track`, `achieved`, `partial`, `missed`, `dropped`.",
            "enum": [
              "on_track",
              "at_risk",
              "off_track",
              "on_hold",
              "complete",
              "achieved",
              "partial",
              "missed",
              "dropped"
            ],
            "type": "string"
          },
          "text": {
            "description": "The text content of the status update.",
            "example": "The project is moving forward according to plan...",
            "type": "string"
          },
          "title": {
            "description": "The title of the status update.",
            "example": "Status Update - Jun 15",
            "type": "string"
          }
        },
        "required": [
          "text",
          "status_type",
          "parent"
        ],
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "status_update"
        }
      },
      "sdk__StatusUpdateResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *status update* is an update on the progress of a particular project, portfolio, or goal, and is sent out to all of its parent's followers when created. These updates include both text describing the update and a `status_type` intended to represent the overall state of the object.",
        "properties": {
          "author": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "created_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "hearted": {
            "description": "*Deprecated - please use liked instead* True if the status is hearted by the authorized user, false if not.",
            "example": true,
            "readOnly": true,
            "type": "boolean"
          },
          "hearts": {
            "description": "*Deprecated - please use likes instead* Array of likes for users who have hearted this status.",
            "items": {
              "description": "An object to represent a user's like.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the object, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string"
                },
                "user": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "*Read-only except when same user as requester*. The user's name.",
                      "example": "Greg Sanchez",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "user"
                  }
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "html_text": {
            "description": "[Opt In](/docs/inputoutput-options). The text content of the status update with formatting as HTML. See [rich text](/docs/rich-text).",
            "example": "<body>The project <strong>is</strong> moving forward according to plan...</body>",
            "type": "string"
          },
          "liked": {
            "description": "True if the status is liked by the authorized user, false if not.",
            "example": true,
            "type": "boolean"
          },
          "likes": {
            "description": "Array of likes for users who have liked this status.",
            "items": {
              "description": "An object to represent a user's like.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the object, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string"
                },
                "user": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "*Read-only except when same user as requester*. The user's name.",
                      "example": "Greg Sanchez",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "user"
                  }
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "modified_at": {
            "description": "The time at which this project status was last modified.\n*Note: This does not currently reflect any changes in associations such as comments that may have been added or removed from the status.*",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "num_hearts": {
            "description": "*Deprecated - please use likes instead* The number of users who have hearted this status.",
            "example": 5,
            "readOnly": true,
            "type": "integer"
          },
          "num_likes": {
            "description": "The number of users who have liked this status.",
            "example": 5,
            "readOnly": true,
            "type": "integer"
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\nThe parent of the status update. This can be a project, goal or portfolio, and indicates that this status was sent on that object.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          "reaction_summary": {
            "description": "Summary of emoji reactions on this status.",
            "items": {
              "description": "A summary of an emoji reaction on an object.",
              "properties": {
                "count": {
                  "description": "The number of reactions with the emoji variant on the object.",
                  "example": 1,
                  "type": "number"
                },
                "emoji_base": {
                  "description": "The emoji base character used in the reaction.",
                  "example": "👎",
                  "type": "string"
                },
                "reacted": {
                  "description": "Whether the current user has reacted with the emoji variant on the object.",
                  "example": false,
                  "type": "boolean"
                },
                "variant": {
                  "description": "The full emoji string used in the reaction.",
                  "example": "👎🏼",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe `resource_subtype`s for `status` objects represent the type of their parent.",
            "enum": [
              "project_status_update",
              "portfolio_status_update",
              "goal_status_update"
            ],
            "example": "project_status_update",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "status_type": {
            "description": "The type associated with the status update. This represents the current state of the object this object is on.\n\nThe valid values for `status_type` depend on the parent of the status update:\n- Projects: `on_track`, `at_risk`, `off_track`, `on_hold`, `complete`, `dropped`.\n- Portfolios: `on_track`, `at_risk`, `off_track`, `on_hold`, `complete`, `dropped`.\n- Goals: `on_track`, `at_risk`, `off_track`, `achieved`, `partial`, `missed`, `dropped`.",
            "enum": [
              "on_track",
              "at_risk",
              "off_track",
              "on_hold",
              "complete",
              "achieved",
              "partial",
              "missed",
              "dropped"
            ],
            "type": "string"
          },
          "text": {
            "description": "The text content of the status update.",
            "example": "The project is moving forward according to plan...",
            "type": "string"
          },
          "title": {
            "description": "The title of the status update.",
            "example": "Status Update - Jun 15",
            "type": "string"
          }
        },
        "required": [
          "text",
          "status_type"
        ],
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "status_update"
        }
      },
      "sdk__StatusUpdateResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__StatusUpdateResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__StatusUpdateResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__StatusUpdateResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__StoryBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA story represents an activity associated with an object in the Asana system.",
        "properties": {
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_text": {
            "description": "[Opt In](/docs/inputoutput-options). HTML formatted text for a comment. This will not include the name of the creator. See [rich text](/docs/rich-text).",
            "example": "<body>This is a comment.</body>",
            "type": "string"
          },
          "is_pinned": {
            "description": "*Conditional*. Whether the story should be pinned on the resource.",
            "example": false,
            "type": "boolean"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "example": "comment_added",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "sticker_name": {
            "description": "The name of the sticker in this story. `null` if there is no sticker.",
            "enum": [
              "green_checkmark",
              "people_dancing",
              "dancing_unicorn",
              "heart",
              "party_popper",
              "people_waving_flags",
              "splashing_narwhal",
              "trophy",
              "yeti_riding_unicorn",
              "celebrating_people",
              "determined_climbers",
              "phoenix_spreading_love"
            ],
            "example": "dancing_unicorn",
            "type": "string"
          },
          "text": {
            "description": "The plain text of the comment to add. Cannot be used with html_text.",
            "example": "This is a comment.",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "story"
        }
      },
      "sdk__StoryCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA story represents an activity associated with an object in the Asana system.",
        "properties": {
          "anchor_gid": {
            "description": "*Conditional*. The GID of the object this comment is anchored to. For a top-level task comment this is the task GID; for a threaded reply this is the parent comment's envelope GID (`comment_gid`). Also present on sticker stories. Request with `opt_fields=anchor_gid` on story reads.",
            "example": "12345",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "comment_gid": {
            "description": "*Conditional*. The GID of this comment's envelope, distinct from the story `gid`. Request with `opt_fields=comment_gid` on story reads. For a top-level task comment, pass this value as `parent_comment` when creating a threaded reply. Null for a legacy comment without an envelope; absent on non-comment stories.",
            "example": "12345",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "created_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "example": "comment_added",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "text": {
            "description": "*Create-only*. Human-readable text for the story or comment.\nThis will not include the name of the creator.\n*Note: This is not guaranteed to be stable for a given type of story. For example, text for a reassignment may not always say “assigned to …” as the text for a story can both be edited and change based on the language settings of the user making the request.*\nUse the `resource_subtype` property to discover the action that created the story.",
            "example": "marked today",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "story"
        }
      },
      "sdk__StoryRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA story represents an activity associated with an object in the Asana system.",
        "properties": {
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_text": {
            "description": "[Opt In](/docs/inputoutput-options). HTML formatted text for a comment. This will not include the name of the creator. See [rich text](/docs/rich-text).",
            "example": "<body>This is a comment.</body>",
            "type": "string"
          },
          "is_pinned": {
            "description": "*Conditional*. Whether the story should be pinned on the resource.",
            "example": false,
            "type": "boolean"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "example": "comment_added",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "sticker_name": {
            "description": "The name of the sticker in this story. `null` if there is no sticker.",
            "enum": [
              "green_checkmark",
              "people_dancing",
              "dancing_unicorn",
              "heart",
              "party_popper",
              "people_waving_flags",
              "splashing_narwhal",
              "trophy",
              "yeti_riding_unicorn",
              "celebrating_people",
              "determined_climbers",
              "phoenix_spreading_love"
            ],
            "example": "dancing_unicorn",
            "type": "string"
          },
          "text": {
            "description": "The plain text of the comment to add. Cannot be used with html_text.",
            "example": "This is a comment.",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "story"
        }
      },
      "sdk__StoryResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA story represents an activity associated with an object in the Asana system.",
        "properties": {
          "anchor_gid": {
            "description": "*Conditional*. The GID of the object this comment is anchored to. For a top-level task comment this is the task GID; for a threaded reply this is the parent comment's envelope GID (`comment_gid`). Also present on sticker stories. Request with `opt_fields=anchor_gid` on story reads.",
            "example": "12345",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "assignee": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "comment_gid": {
            "description": "*Conditional*. The GID of this comment's envelope, distinct from the story `gid`. Request with `opt_fields=comment_gid` on story reads. For a top-level task comment, pass this value as `parent_comment` when creating a threaded reply. Null for a legacy comment without an envelope; absent on non-comment stories.",
            "example": "12345",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "created_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "custom_field": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.",
            "properties": {
              "date_value": {
                "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                "nullable": true,
                "properties": {
                  "date": {
                    "description": "A string representing the date in YYYY-MM-DD format.",
                    "example": "2024-08-23",
                    "type": "string"
                  },
                  "date_time": {
                    "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                    "example": "2024-08-23T22:00:00.000Z",
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "display_value": {
                "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                "example": "blue",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "enabled": {
                "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                "example": true,
                "readOnly": true,
                "type": "boolean"
              },
              "enum_options": {
                "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                "items": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                  "properties": {
                    "color": {
                      "description": "The color of the enum option. Defaults to `none`.",
                      "example": "blue",
                      "type": "string"
                    },
                    "enabled": {
                      "description": "Whether or not the enum option is a selectable value for the custom field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the enum option.",
                      "example": "Low",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "enum_option"
                  }
                },
                "type": "array"
              },
              "enum_value": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                "nullable": true,
                "properties": {
                  "color": {
                    "description": "The color of the enum option. Defaults to `none`.",
                    "example": "blue",
                    "type": "string"
                  },
                  "enabled": {
                    "description": "Whether or not the enum option is a selectable value for the custom field.",
                    "example": true,
                    "type": "boolean"
                  },
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the enum option.",
                    "example": "Low",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "enum_option"
                }
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "id_prefix": {
                "description": "This field is the unique custom ID string for the custom field.",
                "example": "ID",
                "nullable": true,
                "type": "string"
              },
              "input_restrictions": {
                "example": [
                  "task"
                ],
                "items": {
                  "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                  "enum": [
                    "task",
                    "project",
                    "portfolio",
                    "goal"
                  ],
                  "type": "string"
                },
                "type": "array"
              },
              "is_formula_field": {
                "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                "example": false,
                "type": "boolean"
              },
              "is_lookup_field": {
                "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                "example": false,
                "type": "boolean"
              },
              "multi_enum_values": {
                "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                "items": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                  "properties": {
                    "color": {
                      "description": "The color of the enum option. Defaults to `none`.",
                      "example": "blue",
                      "type": "string"
                    },
                    "enabled": {
                      "description": "Whether or not the enum option is a selectable value for the custom field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the enum option.",
                      "example": "Low",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "enum_option"
                  }
                },
                "type": "array"
              },
              "name": {
                "description": "The name of the custom field.",
                "example": "Status",
                "type": "string"
              },
              "number_value": {
                "description": "*Conditional*. This number is the value of a `number` custom field.",
                "example": 5.2,
                "nullable": true,
                "type": "number"
              },
              "representation_type": {
                "description": "This field tells the type of the custom field.",
                "enum": [
                  "text",
                  "enum",
                  "multi_enum",
                  "number",
                  "date",
                  "people",
                  "formula",
                  "custom_id",
                  "reference"
                ],
                "example": "number",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              },
              "text_value": {
                "description": "*Conditional*. This string is the value of a `text` custom field.",
                "example": "Some Value",
                "nullable": true,
                "type": "string"
              },
              "type": {
                "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                "enum": [
                  "text",
                  "enum",
                  "multi_enum",
                  "number",
                  "date",
                  "people",
                  "reference"
                ],
                "readOnly": true,
                "type": "string"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "custom_field"
            }
          },
          "dependency": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe *task* is the basic object around which many operations in Asana are centered.",
            "properties": {
              "created_by": {
                "description": "[Opt In](/docs/inputoutput-options). A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource.",
                    "example": "1111",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of resource.",
                    "example": "user",
                    "type": "string"
                  }
                },
                "readOnly": true,
                "type": "object"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the task.",
                "example": "Bug Task",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe resource_subtype `milestone` represent a single moment in time. This means tasks with this subtype cannot have a start_date.",
                "enum": [
                  "default_task",
                  "milestone",
                  "approval",
                  "custom"
                ],
                "example": "default_task",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "task"
            }
          },
          "duplicate_of": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe *task* is the basic object around which many operations in Asana are centered.",
            "properties": {
              "created_by": {
                "description": "[Opt In](/docs/inputoutput-options). A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource.",
                    "example": "1111",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of resource.",
                    "example": "user",
                    "type": "string"
                  }
                },
                "readOnly": true,
                "type": "object"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the task.",
                "example": "Bug Task",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe resource_subtype `milestone` represent a single moment in time. This means tasks with this subtype cannot have a start_date.",
                "enum": [
                  "default_task",
                  "milestone",
                  "approval",
                  "custom"
                ],
                "example": "default_task",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "task"
            }
          },
          "duplicated_from": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe *task* is the basic object around which many operations in Asana are centered.",
            "properties": {
              "created_by": {
                "description": "[Opt In](/docs/inputoutput-options). A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource.",
                    "example": "1111",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of resource.",
                    "example": "user",
                    "type": "string"
                  }
                },
                "readOnly": true,
                "type": "object"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the task.",
                "example": "Bug Task",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe resource_subtype `milestone` represent a single moment in time. This means tasks with this subtype cannot have a start_date.",
                "enum": [
                  "default_task",
                  "milestone",
                  "approval",
                  "custom"
                ],
                "example": "default_task",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "task"
            }
          },
          "follower": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "hearted": {
            "description": "*Deprecated - please use likes instead*\n*Conditional*. True if the story is hearted by the authorized user, false if not.",
            "example": false,
            "readOnly": true,
            "type": "boolean"
          },
          "hearts": {
            "description": "*Deprecated - please use likes instead*\n\n*Conditional*. Array of likes for users who have hearted this story.",
            "items": {
              "description": "An object to represent a user's like.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the object, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string"
                },
                "user": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "*Read-only except when same user as requester*. The user's name.",
                      "example": "Greg Sanchez",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "user"
                  }
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "html_text": {
            "description": "[Opt In](/docs/inputoutput-options). HTML formatted text for a comment. This will not include the name of the creator. See [rich text](/docs/rich-text).",
            "example": "<body>This is a comment.</body>",
            "type": "string"
          },
          "is_editable": {
            "description": "*Conditional*. Whether the text of the story can be edited after creation.",
            "example": false,
            "readOnly": true,
            "type": "boolean"
          },
          "is_edited": {
            "description": "*Conditional*. Whether the text of the story has been edited after creation.",
            "example": false,
            "readOnly": true,
            "type": "boolean"
          },
          "is_pinned": {
            "description": "*Conditional*. Whether the story should be pinned on the resource.",
            "example": false,
            "type": "boolean"
          },
          "liked": {
            "description": "*Conditional*. True if the story is liked by the authorized user, false if not.",
            "example": false,
            "readOnly": true,
            "type": "boolean"
          },
          "likes": {
            "description": "*Conditional*. Array of likes for users who have liked this story.",
            "items": {
              "description": "An object to represent a user's like.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the object, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string"
                },
                "user": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "*Read-only except when same user as requester*. The user's name.",
                      "example": "Greg Sanchez",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "user"
                  }
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "new_approval_status": {
            "description": "*Conditional*. The new value of approval status.",
            "example": "approved",
            "readOnly": true,
            "type": "string"
          },
          "new_date_value": {
            "allOf": [
              {
                "description": "*Conditional*",
                "properties": {
                  "due_at": {
                    "description": "The UTC date and time on which this task is due, or null if the task has no due time. This takes an ISO 8601 date string in UTC and should not be used together with `due_on`.",
                    "example": "2019-09-15T02:06:58.158Z",
                    "format": "date-time",
                    "nullable": true,
                    "type": "string"
                  },
                  "due_on": {
                    "description": "The localized day on which this goal is due. This takes a date with format `YYYY-MM-DD`.",
                    "example": "2019-09-15",
                    "format": "date",
                    "type": "string"
                  },
                  "start_on": {
                    "description": "The day on which work for this goal begins, or null if the goal has no start date. This takes a date with `YYYY-MM-DD` format, and cannot be set unless there is an accompanying due date.",
                    "example": "2019-09-14",
                    "format": "date",
                    "nullable": true,
                    "type": "string"
                  }
                },
                "readOnly": true,
                "type": "object"
              },
              {
                "description": "*Conditional* The new value of a date custom field story."
              }
            ],
            "readOnly": true
          },
          "new_dates": {
            "description": "*Conditional*",
            "properties": {
              "due_at": {
                "description": "The UTC date and time on which this task is due, or null if the task has no due time. This takes an ISO 8601 date string in UTC and should not be used together with `due_on`.",
                "example": "2019-09-15T02:06:58.158Z",
                "format": "date-time",
                "nullable": true,
                "type": "string"
              },
              "due_on": {
                "description": "The localized day on which this goal is due. This takes a date with format `YYYY-MM-DD`.",
                "example": "2019-09-15",
                "format": "date",
                "type": "string"
              },
              "start_on": {
                "description": "The day on which work for this goal begins, or null if the goal has no start date. This takes a date with `YYYY-MM-DD` format, and cannot be set unless there is an accompanying due date.",
                "example": "2019-09-14",
                "format": "date",
                "nullable": true,
                "type": "string"
              }
            },
            "readOnly": true,
            "type": "object"
          },
          "new_enum_value": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
            "properties": {
              "color": {
                "description": "The color of the enum option. Defaults to `none`.",
                "example": "blue",
                "type": "string"
              },
              "enabled": {
                "description": "Whether or not the enum option is a selectable value for the custom field.",
                "example": true,
                "type": "boolean"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the enum option.",
                "example": "Low",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "enum_option"
            }
          },
          "new_multi_enum_values": {
            "description": "*Conditional*. The new value of a multi-enum custom field story.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
              "properties": {
                "color": {
                  "description": "The color of the enum option. Defaults to `none`.",
                  "example": "blue",
                  "type": "string"
                },
                "enabled": {
                  "description": "Whether or not the enum option is a selectable value for the custom field.",
                  "example": true,
                  "type": "boolean"
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "The name of the enum option.",
                  "example": "Low",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "enum_option"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "new_name": {
            "description": "*Conditional* The updated name of the task after a name change.",
            "example": "This is the new name",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "new_number_value": {
            "description": "*Conditional* The new value of a number-type custom field after the update.",
            "example": 2,
            "readOnly": true,
            "type": "integer"
          },
          "new_people_value": {
            "description": "*Conditional*. The new value of a people custom field story.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "*Read-only except when same user as requester*. The user's name.",
                  "example": "Greg Sanchez",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "user"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "new_resource_subtype": {
            "description": "*Conditional*",
            "example": "milestone",
            "readOnly": true,
            "type": "string"
          },
          "new_section": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *section* is a subdivision of a project that groups tasks together. It can either be a header above a list of tasks in a list view or a column in a board view of a project.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the section (i.e. the text displayed as the section header).",
                "example": "Next Actions",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "section"
            }
          },
          "new_text_value": {
            "description": "*Conditional* The new value of a text-type field after it was updated.",
            "example": "This is the new text",
            "readOnly": true,
            "type": "string"
          },
          "num_hearts": {
            "description": "*Deprecated - please use likes instead*\n\n*Conditional*. The number of users who have hearted this story.",
            "example": 5,
            "readOnly": true,
            "type": "integer"
          },
          "num_likes": {
            "description": "*Conditional*. The number of users who have liked this story.",
            "example": 5,
            "readOnly": true,
            "type": "integer"
          },
          "old_approval_status": {
            "description": "*Conditional*. The old value of approval status.",
            "example": "pending",
            "readOnly": true,
            "type": "string"
          },
          "old_date_value": {
            "allOf": [
              {
                "description": "*Conditional*",
                "properties": {
                  "due_at": {
                    "description": "The UTC date and time on which this task is due, or null if the task has no due time. This takes an ISO 8601 date string in UTC and should not be used together with `due_on`.",
                    "example": "2019-09-15T02:06:58.158Z",
                    "format": "date-time",
                    "nullable": true,
                    "type": "string"
                  },
                  "due_on": {
                    "description": "The localized day on which this goal is due. This takes a date with format `YYYY-MM-DD`.",
                    "example": "2019-09-15",
                    "format": "date",
                    "type": "string"
                  },
                  "start_on": {
                    "description": "The day on which work for this goal begins, or null if the goal has no start date. This takes a date with `YYYY-MM-DD` format, and cannot be set unless there is an accompanying due date.",
                    "example": "2019-09-14",
                    "format": "date",
                    "nullable": true,
                    "type": "string"
                  }
                },
                "readOnly": true,
                "type": "object"
              },
              {
                "description": "*Conditional*. The old value of a date custom field story."
              }
            ],
            "readOnly": true
          },
          "old_dates": {
            "description": "*Conditional*",
            "properties": {
              "due_at": {
                "description": "The UTC date and time on which this task is due, or null if the task has no due time. This takes an ISO 8601 date string in UTC and should not be used together with `due_on`.",
                "example": "2019-09-15T02:06:58.158Z",
                "format": "date-time",
                "nullable": true,
                "type": "string"
              },
              "due_on": {
                "description": "The localized day on which this goal is due. This takes a date with format `YYYY-MM-DD`.",
                "example": "2019-09-15",
                "format": "date",
                "type": "string"
              },
              "start_on": {
                "description": "The day on which work for this goal begins, or null if the goal has no start date. This takes a date with `YYYY-MM-DD` format, and cannot be set unless there is an accompanying due date.",
                "example": "2019-09-14",
                "format": "date",
                "nullable": true,
                "type": "string"
              }
            },
            "readOnly": true,
            "type": "object"
          },
          "old_enum_value": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
            "properties": {
              "color": {
                "description": "The color of the enum option. Defaults to `none`.",
                "example": "blue",
                "type": "string"
              },
              "enabled": {
                "description": "Whether or not the enum option is a selectable value for the custom field.",
                "example": true,
                "type": "boolean"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the enum option.",
                "example": "Low",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "enum_option"
            }
          },
          "old_multi_enum_values": {
            "description": "*Conditional*. The old value of a multi-enum custom field story.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
              "properties": {
                "color": {
                  "description": "The color of the enum option. Defaults to `none`.",
                  "example": "blue",
                  "type": "string"
                },
                "enabled": {
                  "description": "Whether or not the enum option is a selectable value for the custom field.",
                  "example": true,
                  "type": "boolean"
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "The name of the enum option.",
                  "example": "Low",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "enum_option"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "old_name": {
            "description": "*Conditional* The previous name of the task before a name change.",
            "example": "This was the old name",
            "type": "string"
          },
          "old_number_value": {
            "description": "*Conditional* The previous value of a number-type custom field before the update.",
            "example": 1,
            "nullable": true,
            "readOnly": true,
            "type": "integer"
          },
          "old_people_value": {
            "description": "*Conditional*. The old value of a people custom field story.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "*Read-only except when same user as requester*. The user's name.",
                  "example": "Greg Sanchez",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "user"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "old_resource_subtype": {
            "description": "*Conditional*",
            "example": "default_task",
            "readOnly": true,
            "type": "string"
          },
          "old_section": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *section* is a subdivision of a project that groups tasks together. It can either be a header above a list of tasks in a list view or a column in a board view of a project.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the section (i.e. the text displayed as the section header).",
                "example": "Next Actions",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "section"
            }
          },
          "old_text_value": {
            "description": "*Conditional* The previous value of a text-type field before it was updated.",
            "example": "This was the old text",
            "readOnly": true,
            "type": "string"
          },
          "previews": {
            "description": "*Conditional*. A collection of previews to be displayed in the story.\n\n*Note: This property only exists for comment stories.*",
            "items": {
              "description": "A collection of rich text that will be displayed as a preview to another app.\n\nThis is read-only except for a small group of whitelisted apps.",
              "properties": {
                "fallback": {
                  "description": "Some fallback text to display if unable to display the full preview.",
                  "example": "Greg: Great! I like this idea.\\n\\nhttps//a_company.slack.com/archives/ABCDEFG/12345678",
                  "type": "string"
                },
                "footer": {
                  "description": "Text to display in the footer.",
                  "example": "Mar 17, 2019 1:25 PM",
                  "type": "string"
                },
                "header": {
                  "description": "Text to display in the header.",
                  "example": "Asana for Slack",
                  "type": "string"
                },
                "header_link": {
                  "description": "Where the header will link to.",
                  "example": "https://asana.comn/apps/slack",
                  "type": "string"
                },
                "html_text": {
                  "description": "HTML formatted text for the body of the preview. See [rich text](/docs/rich-text#reading-rich-text).",
                  "example": "<body>Great! I like this idea.</body>",
                  "type": "string"
                },
                "text": {
                  "description": "Text for the body of the preview.",
                  "example": "Great! I like this idea.",
                  "type": "string"
                },
                "title": {
                  "description": "Text to display as the title.",
                  "example": "Greg",
                  "type": "string"
                },
                "title_link": {
                  "description": "Where to title will link to.",
                  "example": "https://asana.slack.com/archives/ABCDEFG/12345678",
                  "type": "string"
                }
              },
              "readOnly": true,
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "project": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          "reaction_summary": {
            "description": "Summary of emoji reactions on this story.",
            "items": {
              "description": "A summary of an emoji reaction on an object.",
              "properties": {
                "count": {
                  "description": "The number of reactions with the emoji variant on the object.",
                  "example": 1,
                  "type": "number"
                },
                "emoji_base": {
                  "description": "The emoji base character used in the reaction.",
                  "example": "👎",
                  "type": "string"
                },
                "reacted": {
                  "description": "Whether the current user has reacted with the emoji variant on the object.",
                  "example": false,
                  "type": "boolean"
                },
                "variant": {
                  "description": "The full emoji string used in the reaction.",
                  "example": "👎🏼",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "example": "comment_added",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "source": {
            "description": "The component of the Asana product the user used to trigger the story.",
            "enum": [
              "web",
              "email",
              "mobile",
              "api",
              "unknown"
            ],
            "example": "web",
            "readOnly": true,
            "type": "string"
          },
          "sticker_name": {
            "description": "The name of the sticker in this story. `null` if there is no sticker.",
            "enum": [
              "green_checkmark",
              "people_dancing",
              "dancing_unicorn",
              "heart",
              "party_popper",
              "people_waving_flags",
              "splashing_narwhal",
              "trophy",
              "yeti_riding_unicorn",
              "celebrating_people",
              "determined_climbers",
              "phoenix_spreading_love"
            ],
            "example": "dancing_unicorn",
            "type": "string"
          },
          "story": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA story represents an activity associated with an object in the Asana system.",
            "properties": {
              "anchor_gid": {
                "description": "*Conditional*. The GID of the object this comment is anchored to. For a top-level task comment this is the task GID; for a threaded reply this is the parent comment's envelope GID (`comment_gid`). Also present on sticker stories. Request with `opt_fields=anchor_gid` on story reads.",
                "example": "12345",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "comment_gid": {
                "description": "*Conditional*. The GID of this comment's envelope, distinct from the story `gid`. Request with `opt_fields=comment_gid` on story reads. For a top-level task comment, pass this value as `parent_comment` when creating a threaded reply. Null for a legacy comment without an envelope; absent on non-comment stories.",
                "example": "12345",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "created_at": {
                "description": "The time at which this resource was created.",
                "example": "2012-02-22T02:06:58.147Z",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "created_by": {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "example": "comment_added",
                "readOnly": true,
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              },
              "text": {
                "description": "*Create-only*. Human-readable text for the story or comment.\nThis will not include the name of the creator.\n*Note: This is not guaranteed to be stable for a given type of story. For example, text for a reassignment may not always say “assigned to …” as the text for a story can both be edited and change based on the language settings of the user making the request.*\nUse the `resource_subtype` property to discover the action that created the story.",
                "example": "marked today",
                "type": "string"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "story"
            }
          },
          "tag": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *tag* is a label that can be attached to any task in Asana. It exists in a single workspace or organization.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "Name of the tag. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "tag"
            }
          },
          "target": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe *task* is the basic object around which many operations in Asana are centered.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe *task* is the basic object around which many operations in Asana are centered.\nThe object this story is associated with. Currently may only be a task.",
            "properties": {
              "created_by": {
                "description": "[Opt In](/docs/inputoutput-options). A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource.",
                    "example": "1111",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of resource.",
                    "example": "user",
                    "type": "string"
                  }
                },
                "readOnly": true,
                "type": "object"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the task.",
                "example": "Bug Task",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe resource_subtype `milestone` represent a single moment in time. This means tasks with this subtype cannot have a start_date.",
                "enum": [
                  "default_task",
                  "milestone",
                  "approval",
                  "custom"
                ],
                "example": "default_task",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "task"
            }
          },
          "task": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe *task* is the basic object around which many operations in Asana are centered.",
            "properties": {
              "created_by": {
                "description": "[Opt In](/docs/inputoutput-options). A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource.",
                    "example": "1111",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of resource.",
                    "example": "user",
                    "type": "string"
                  }
                },
                "readOnly": true,
                "type": "object"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the task.",
                "example": "Bug Task",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe resource_subtype `milestone` represent a single moment in time. This means tasks with this subtype cannot have a start_date.",
                "enum": [
                  "default_task",
                  "milestone",
                  "approval",
                  "custom"
                ],
                "example": "default_task",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "task"
            }
          },
          "text": {
            "description": "The plain text of the comment to add. Cannot be used with html_text.",
            "example": "This is a comment.",
            "type": "string"
          },
          "type": {
            "enum": [
              "comment",
              "system"
            ],
            "example": "comment",
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "story"
        }
      },
      "sdk__StoryResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__StoryResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__StoryResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__StoryResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__StoryResponseDates": {
        "description": "*Conditional*",
        "properties": {
          "due_at": {
            "description": "The UTC date and time on which this task is due, or null if the task has no due time. This takes an ISO 8601 date string in UTC and should not be used together with `due_on`.",
            "example": "2019-09-15T02:06:58.158Z",
            "format": "date-time",
            "nullable": true,
            "type": "string"
          },
          "due_on": {
            "description": "The localized day on which this goal is due. This takes a date with format `YYYY-MM-DD`.",
            "example": "2019-09-15",
            "format": "date",
            "type": "string"
          },
          "start_on": {
            "description": "The day on which work for this goal begins, or null if the goal has no start date. This takes a date with `YYYY-MM-DD` format, and cannot be set unless there is an accompanying due date.",
            "example": "2019-09-14",
            "format": "date",
            "nullable": true,
            "type": "string"
          }
        },
        "readOnly": true,
        "type": "object"
      },
      "sdk__TableBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *table* is a container for structured records (rows), with columns defined by custom field settings.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the table.",
            "example": "Vendor contracts",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "table"
        }
      },
      "sdk__TableCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *table* is a container for structured records (rows), with columns defined by custom field settings.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the table.",
            "example": "Vendor contracts",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "table"
        }
      },
      "sdk__TableMembershipCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA user or team's membership in a table.",
        "properties": {
          "access_level": {
            "description": "The member's access level in the table.",
            "enum": [
              "admin",
              "editor",
              "commenter",
              "viewer"
            ],
            "example": "viewer",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the member",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of the member (team or user)",
                "example": "user",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "member"
            }
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *table* is a container for structured records (rows), with columns defined by custom field settings.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the table.",
                "example": "Vendor contracts",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "table"
            }
          },
          "resource_subtype": {
            "description": "Type of the membership.",
            "example": "table_membership",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "membership"
        }
      },
      "sdk__TableMembershipResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA user or team's membership in a table.",
        "properties": {
          "access_level": {
            "description": "The member's access level in the table.",
            "enum": [
              "admin",
              "editor",
              "commenter",
              "viewer"
            ],
            "example": "viewer",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "member": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *member* object represents either a team or user.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the member",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of the member (team or user)",
                "example": "user",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "member"
            }
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *table* is a container for structured records (rows), with columns defined by custom field settings.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the table.",
                "example": "Vendor contracts",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "table"
            }
          },
          "resource_subtype": {
            "description": "Type of the membership.",
            "example": "table_membership",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "membership"
        }
      },
      "sdk__TableRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *table* is a container for structured records (rows), with columns defined by custom field settings.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the table.",
            "example": "Vendor contracts",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "workspace": {
            "description": "*Create-only*. The workspace or organization in which this table will be created. Once created, tables cannot be moved to a different workspace.",
            "example": "1331",
            "type": "string"
          }
        },
        "required": [
          "name",
          "workspace"
        ],
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "table"
        }
      },
      "sdk__TableResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *table* is a container for structured records (rows), with columns defined by custom field settings.",
        "properties": {
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "custom_field_settings": {
            "description": "Array of custom field definitions that are enabled for the table. These represent which custom fields are available to records in the table, but do not include any values.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *custom field table setting* represents the many-to-many join of a custom field and a table, storing information relevant to that particular pairing.",
              "properties": {
                "custom_field": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.\nThe custom field that is applied to the table.",
                  "properties": {
                    "date_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                      "nullable": true,
                      "properties": {
                        "date": {
                          "description": "A string representing the date in YYYY-MM-DD format.",
                          "example": "2024-08-23",
                          "type": "string"
                        },
                        "date_time": {
                          "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                          "example": "2024-08-23T22:00:00.000Z",
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    "display_value": {
                      "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                      "example": "blue",
                      "nullable": true,
                      "readOnly": true,
                      "type": "string"
                    },
                    "enabled": {
                      "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                      "example": true,
                      "readOnly": true,
                      "type": "boolean"
                    },
                    "enum_options": {
                      "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                        "properties": {
                          "color": {
                            "description": "The color of the enum option. Defaults to `none`.",
                            "example": "blue",
                            "type": "string"
                          },
                          "enabled": {
                            "description": "Whether or not the enum option is a selectable value for the custom field.",
                            "example": true,
                            "type": "boolean"
                          },
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "The name of the enum option.",
                            "example": "Low",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object",
                        "x-docs-overrides": {
                          "properties.resource_type.example": "enum_option"
                        }
                      },
                      "type": "array"
                    },
                    "enum_value": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                      "nullable": true,
                      "properties": {
                        "color": {
                          "description": "The color of the enum option. Defaults to `none`.",
                          "example": "blue",
                          "type": "string"
                        },
                        "enabled": {
                          "description": "Whether or not the enum option is a selectable value for the custom field.",
                          "example": true,
                          "type": "boolean"
                        },
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "The name of the enum option.",
                          "example": "Low",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "enum_option"
                      }
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "id_prefix": {
                      "description": "This field is the unique custom ID string for the custom field.",
                      "example": "ID",
                      "nullable": true,
                      "type": "string"
                    },
                    "input_restrictions": {
                      "example": [
                        "task"
                      ],
                      "items": {
                        "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                        "enum": [
                          "task",
                          "project",
                          "portfolio",
                          "goal"
                        ],
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "is_formula_field": {
                      "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                      "example": false,
                      "type": "boolean"
                    },
                    "is_lookup_field": {
                      "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                      "example": false,
                      "type": "boolean"
                    },
                    "multi_enum_values": {
                      "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                        "properties": {
                          "color": {
                            "description": "The color of the enum option. Defaults to `none`.",
                            "example": "blue",
                            "type": "string"
                          },
                          "enabled": {
                            "description": "Whether or not the enum option is a selectable value for the custom field.",
                            "example": true,
                            "type": "boolean"
                          },
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "The name of the enum option.",
                            "example": "Low",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object",
                        "x-docs-overrides": {
                          "properties.resource_type.example": "enum_option"
                        }
                      },
                      "type": "array"
                    },
                    "name": {
                      "description": "The name of the custom field.",
                      "example": "Status",
                      "type": "string"
                    },
                    "number_value": {
                      "description": "*Conditional*. This number is the value of a `number` custom field.",
                      "example": 5.2,
                      "nullable": true,
                      "type": "number"
                    },
                    "representation_type": {
                      "description": "This field tells the type of the custom field.",
                      "enum": [
                        "text",
                        "enum",
                        "multi_enum",
                        "number",
                        "date",
                        "people",
                        "formula",
                        "custom_id",
                        "reference"
                      ],
                      "example": "number",
                      "readOnly": true,
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    },
                    "text_value": {
                      "description": "*Conditional*. This string is the value of a `text` custom field.",
                      "example": "Some Value",
                      "nullable": true,
                      "type": "string"
                    },
                    "type": {
                      "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                      "enum": [
                        "text",
                        "enum",
                        "multi_enum",
                        "number",
                        "date",
                        "people",
                        "reference"
                      ],
                      "readOnly": true,
                      "type": "string"
                    }
                  },
                  "readOnly": true,
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "custom_field"
                  }
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "is_important": {
                  "description": "`is_important` is used in the Asana web application to determine if this custom field is displayed in the list/grid view of a table.",
                  "readOnly": true,
                  "type": "boolean"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "custom_field_setting"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "default_access_level": {
            "description": "The default access level for users who join or are added as members of the table.",
            "enum": [
              "admin",
              "editor",
              "commenter",
              "viewer"
            ],
            "example": "viewer",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "modified_at": {
            "description": "The time at which this table was last modified.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "name": {
            "description": "The name of the table.",
            "example": "Vendor contracts",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "workspace": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.\n*Create-only*. The workspace or organization this table is associated with. Once created, tables cannot be moved to a different workspace. This attribute can only be specified at creation time.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the workspace.",
                "example": "My Company Workspace",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "workspace"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "table"
        }
      },
      "sdk__TableResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__TableResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__TableResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__TableResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__TableUpdateRequest": {
        "properties": {
          "default_access_level": {
            "description": "The default access level for users who join or are added as members of the table.",
            "enum": [
              "admin",
              "editor",
              "commenter",
              "viewer"
            ],
            "example": "viewer",
            "type": "string"
          },
          "name": {
            "description": "The name of the table.",
            "example": "Vendor contracts",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__TagBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *tag* is a label that can be attached to any task in Asana. It exists in a single workspace or organization.",
        "properties": {
          "color": {
            "description": "Color of the tag.",
            "enum": [
              "dark-pink",
              "dark-green",
              "dark-blue",
              "dark-red",
              "dark-teal",
              "dark-brown",
              "dark-orange",
              "dark-purple",
              "dark-warm-gray",
              "light-pink",
              "light-green",
              "light-blue",
              "light-red",
              "light-teal",
              "light-brown",
              "light-orange",
              "light-purple",
              "light-warm-gray",
              null
            ],
            "example": "light-green",
            "nullable": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "Name of the tag. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.",
            "example": "Stuff to buy",
            "type": "string"
          },
          "notes": {
            "description": "Free-form textual information associated with the tag (i.e. its description).",
            "example": "Mittens really likes the stuff from Humboldt.",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "tag"
        }
      },
      "sdk__TagBaseRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *tag* is a label that can be attached to any task in Asana. It exists in a single workspace or organization.",
        "properties": {
          "color": {
            "description": "Color of the tag.",
            "enum": [
              "dark-pink",
              "dark-green",
              "dark-blue",
              "dark-red",
              "dark-teal",
              "dark-brown",
              "dark-orange",
              "dark-purple",
              "dark-warm-gray",
              "light-pink",
              "light-green",
              "light-blue",
              "light-red",
              "light-teal",
              "light-brown",
              "light-orange",
              "light-purple",
              "light-warm-gray",
              null
            ],
            "example": "light-green",
            "nullable": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "Name of the tag. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.",
            "example": "Stuff to buy",
            "type": "string"
          },
          "notes": {
            "description": "Free-form textual information associated with the tag (i.e. its description).",
            "example": "Mittens really likes the stuff from Humboldt.",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "tag"
        }
      },
      "sdk__TagCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *tag* is a label that can be attached to any task in Asana. It exists in a single workspace or organization.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "Name of the tag. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.",
            "example": "Stuff to buy",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "tag"
        }
      },
      "sdk__TagCreateRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *tag* is a label that can be attached to any task in Asana. It exists in a single workspace or organization.",
        "properties": {
          "color": {
            "description": "Color of the tag.",
            "enum": [
              "dark-pink",
              "dark-green",
              "dark-blue",
              "dark-red",
              "dark-teal",
              "dark-brown",
              "dark-orange",
              "dark-purple",
              "dark-warm-gray",
              "light-pink",
              "light-green",
              "light-blue",
              "light-red",
              "light-teal",
              "light-brown",
              "light-orange",
              "light-purple",
              "light-warm-gray",
              null
            ],
            "example": "light-green",
            "nullable": true,
            "type": "string"
          },
          "followers": {
            "description": "An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user.",
            "example": [
              "12345",
              "42563"
            ],
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "Name of the tag. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.",
            "example": "Stuff to buy",
            "type": "string"
          },
          "notes": {
            "description": "Free-form textual information associated with the tag (i.e. its description).",
            "example": "Mittens really likes the stuff from Humboldt.",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "workspace": {
            "description": "Gid of an object.",
            "example": "12345",
            "type": "string",
            "x-env-variable": true
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "tag"
        }
      },
      "sdk__TagCreateTagForWorkspaceRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *tag* is a label that can be attached to any task in Asana. It exists in a single workspace or organization.",
        "properties": {
          "color": {
            "description": "Color of the tag.",
            "enum": [
              "dark-pink",
              "dark-green",
              "dark-blue",
              "dark-red",
              "dark-teal",
              "dark-brown",
              "dark-orange",
              "dark-purple",
              "dark-warm-gray",
              "light-pink",
              "light-green",
              "light-blue",
              "light-red",
              "light-teal",
              "light-brown",
              "light-orange",
              "light-purple",
              "light-warm-gray",
              null
            ],
            "example": "light-green",
            "nullable": true,
            "type": "string"
          },
          "followers": {
            "description": "An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user.",
            "example": [
              "12345",
              "42563"
            ],
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "Name of the tag. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.",
            "example": "Stuff to buy",
            "type": "string"
          },
          "notes": {
            "description": "Free-form textual information associated with the tag (i.e. its description).",
            "example": "Mittens really likes the stuff from Humboldt.",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "tag"
        }
      },
      "sdk__TagResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *tag* is a label that can be attached to any task in Asana. It exists in a single workspace or organization.",
        "properties": {
          "color": {
            "description": "Color of the tag.",
            "enum": [
              "dark-pink",
              "dark-green",
              "dark-blue",
              "dark-red",
              "dark-teal",
              "dark-brown",
              "dark-orange",
              "dark-purple",
              "dark-warm-gray",
              "light-pink",
              "light-green",
              "light-blue",
              "light-red",
              "light-teal",
              "light-brown",
              "light-orange",
              "light-purple",
              "light-warm-gray",
              null
            ],
            "example": "light-green",
            "nullable": true,
            "type": "string"
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "followers": {
            "description": "Array of users following this tag.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "*Read-only except when same user as requester*. The user's name.",
                  "example": "Greg Sanchez",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "user"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "Name of the tag. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.",
            "example": "Stuff to buy",
            "type": "string"
          },
          "notes": {
            "description": "Free-form textual information associated with the tag (i.e. its description).",
            "example": "Mittens really likes the stuff from Humboldt.",
            "type": "string"
          },
          "permalink_url": {
            "description": "A url that points directly to the object within Asana.",
            "example": "https://app.asana.com/0/resource/123456789/list",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "workspace": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the workspace.",
                "example": "My Company Workspace",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "workspace"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "tag"
        }
      },
      "sdk__TagResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__TagResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__TagResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__TagResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__TagUpdateRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *tag* is a label that can be attached to any task in Asana. It exists in a single workspace or organization.",
        "properties": {
          "color": {
            "description": "Color of the tag.",
            "enum": [
              "dark-pink",
              "dark-green",
              "dark-blue",
              "dark-red",
              "dark-teal",
              "dark-brown",
              "dark-orange",
              "dark-purple",
              "dark-warm-gray",
              "light-pink",
              "light-green",
              "light-blue",
              "light-red",
              "light-teal",
              "light-brown",
              "light-orange",
              "light-purple",
              "light-warm-gray",
              null
            ],
            "example": "light-green",
            "nullable": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "Name of the tag. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.",
            "example": "Stuff to buy",
            "type": "string"
          },
          "notes": {
            "description": "Free-form textual information associated with the tag (i.e. its description).",
            "example": "Mittens really likes the stuff from Humboldt.",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "tag"
        }
      },
      "sdk__TaskAddFollowersRequest": {
        "properties": {
          "followers": {
            "description": "An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user.",
            "example": [
              "13579",
              "321654"
            ],
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "followers"
        ],
        "type": "object"
      },
      "sdk__TaskAddProjectRequest": {
        "properties": {
          "insert_after": {
            "description": "A task in the project to insert the task after, or `null` to insert at the beginning of the list. When used with `section`, `null` will insert at the beginning of the specified section, otherwise the task must be in the specified section.",
            "example": "124816",
            "nullable": true,
            "type": "string"
          },
          "insert_before": {
            "description": "A task in the project to insert the task before, or `null` to insert at the end of the list. When used with `section`, `null` will insert at the end of the specified section, otherwise the task must be in the specified section.",
            "example": "432134",
            "nullable": true,
            "type": "string"
          },
          "project": {
            "description": "The project to add the task to.",
            "example": "13579",
            "type": "string"
          },
          "section": {
            "description": "A section in the project to insert the task into. The task will be inserted at the bottom of the section unless combined with `insert_before: null` (end of section) or `insert_after: null` (beginning of section). Can also be combined with non-null `insert_before` or `insert_after` to position relative to a task within the section.",
            "example": "987654",
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "project"
        ],
        "type": "object"
      },
      "sdk__TaskAddTagRequest": {
        "properties": {
          "tag": {
            "description": "The tag's gid to add to the task.",
            "example": "13579",
            "type": "string"
          }
        },
        "required": [
          "tag"
        ],
        "type": "object"
      },
      "sdk__TaskBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe *task* is the basic object around which many operations in Asana are centered.",
        "properties": {
          "actual_time_minutes": {
            "description": "This value represents the sum of all the Time Tracking entries in the Actual Time field on a given Task. It is represented as a nullable long value.",
            "example": 200,
            "nullable": true,
            "readOnly": true,
            "type": "number"
          },
          "approval_status": {
            "description": "*Conditional* Reflects the approval status of this task. This field is kept in sync with `completed`, meaning `pending` translates to false while `approved`, `rejected`, and `changes_requested` translate to true. If you set completed to true, this field will be set to `approved`.",
            "enum": [
              "pending",
              "approved",
              "rejected",
              "changes_requested"
            ],
            "example": "pending",
            "type": "string"
          },
          "assigned_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.\nThe user who assigned the task. This field is only returned when requesting it via opt_fields, and will be null if the task has no specific assigner (e.g., tasks created without an explicit assigner).",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "assignee_status": {
            "description": "*Deprecated* Scheduling status of this task for the user it is assigned to. This field can only be set if the assignee is non-null. Setting this field to \"inbox\" or \"upcoming\" inserts it at the top of the section, while the other options will insert at the bottom.",
            "enum": [
              "today",
              "upcoming",
              "later",
              "new",
              "inbox"
            ],
            "example": "upcoming",
            "type": "string"
          },
          "completed": {
            "description": "True if the task is currently marked complete, false if not.",
            "example": false,
            "type": "boolean"
          },
          "completed_at": {
            "description": "The time at which this task was completed, or null if the task is incomplete.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "completed_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "created_by": {
            "description": "[Opt In](/docs/inputoutput-options). A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource.",
                "example": "1111",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of resource.",
                "example": "user",
                "type": "string"
              }
            },
            "readOnly": true,
            "type": "object"
          },
          "dependencies": {
            "description": "[Opt In](/docs/inputoutput-options). Array of resources referencing tasks that this task depends on. The objects contain only the gid of the dependency.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "dependents": {
            "description": "[Opt In](/docs/inputoutput-options). Array of resources referencing tasks that depend on this task. The objects contain only the ID of the dependent.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "due_at": {
            "description": "The UTC date and time on which this task is due, or null if the task has no due time. This takes an ISO 8601 date string in UTC and should not be used together with `due_on`.",
            "example": "2019-09-15T02:06:58.147Z",
            "format": "date-time",
            "nullable": true,
            "type": "string"
          },
          "due_on": {
            "description": "The localized date on which this task is due, or null if the task has no due date. This takes a date with `YYYY-MM-DD` format and should not be used together with `due_at`.",
            "example": "2019-09-15",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "external": {
            "description": "*OAuth Required*. *Conditional*. This field is returned only if external values are set or included by using [Opt In](/docs/inputoutput-options).\nThe external field allows you to store app-specific metadata on tasks, including a gid that can be used to retrieve tasks and a data blob that can store app-specific character strings. Note that you will need to authenticate with Oauth to access or modify this data. Once an external gid is set, you can use the notation `external:custom_gid` to reference your object anywhere in the API where you may use the original object gid. See the page on Custom External Data for more details.",
            "example": {
              "data": "A blob of information",
              "gid": "my_gid"
            },
            "properties": {
              "data": {
                "example": "A blob of information.",
                "type": "string"
              },
              "gid": {
                "example": "1234",
                "type": "string"
              }
            },
            "type": "object"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "has_subtasks_date_mismatch": {
            "description": "[Opt In](/docs/inputoutput-options). True when one or more descendant subtasks have dates outside the task's own date range. This field reflects the latest computed rollup state and returns false when no rollup has been computed.",
            "example": true,
            "readOnly": true,
            "type": "boolean"
          },
          "hearted": {
            "description": "*Deprecated - please use liked instead* True if the task is hearted by the authorized user, false if not.",
            "example": true,
            "readOnly": true,
            "type": "boolean"
          },
          "hearts": {
            "description": "*Deprecated - please use likes instead* Array of likes for users who have hearted this task.",
            "items": {
              "description": "An object to represent a user's like.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the object, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string"
                },
                "user": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "*Read-only except when same user as requester*. The user's name.",
                      "example": "Greg Sanchez",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "user"
                  }
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "html_notes": {
            "description": "[Opt In](/docs/inputoutput-options). The notes of the text with formatting as HTML. See [rich text](/docs/rich-text).",
            "example": "<body>Mittens <em>really</em> likes the stuff from Humboldt.</body>",
            "type": "string"
          },
          "is_rendered_as_separator": {
            "description": "[Opt In](/docs/inputoutput-options). In some contexts tasks can be rendered as a visual separator; for instance, subtasks can appear similar to [sections](/reference/sections) without being true `section` objects. If a `task` object is rendered this way in any context it will have the property `is_rendered_as_separator` set to `true`. This parameter only applies to regular tasks with `resource_subtype` of `default_task`. Tasks with `resource_subtype` of `milestone`, `approval`, or custom task types will not have this property and cannot be rendered as separators.",
            "example": false,
            "readOnly": true,
            "type": "boolean"
          },
          "liked": {
            "description": "True if the task is liked by the authorized user, false if not.",
            "example": true,
            "type": "boolean"
          },
          "likes": {
            "description": "Array of likes for users who have liked this task.",
            "items": {
              "description": "An object to represent a user's like.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the object, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string"
                },
                "user": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "*Read-only except when same user as requester*. The user's name.",
                      "example": "Greg Sanchez",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "user"
                  }
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "memberships": {
            "description": "*Create-only*. Array of projects this task is associated with and the section it is in. At task creation time, this array can be used to add the task to specific sections. After task creation, these associations can be modified using the `addProject` and `removeProject` endpoints. Note that over time, more types of memberships may be added to this property.",
            "items": {
              "properties": {
                "project": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "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.",
                      "example": "Stuff to buy",
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                      "enum": [
                        "default_project",
                        "custom"
                      ],
                      "example": "default_project",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "project"
                  }
                },
                "section": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *section* is a subdivision of a project that groups tasks together. It can either be a header above a list of tasks in a list view or a column in a board view of a project.",
                  "nullable": true,
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the section (i.e. the text displayed as the section header).",
                      "example": "Next Actions",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "section"
                  }
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "modified_at": {
            "description": "The time at which this task was last modified.\n\nThe following conditions will change `modified_at`:\n\n- story is created on a task\n- story is trashed on a task\n- attachment is trashed on a task\n- task is assigned or unassigned\n- custom field value is changed\n- the task itself is trashed\n- Or if any of the following fields are updated:\n  - completed\n  - name\n  - due_date\n  - description\n  - attachments\n  - items\n  - schedule_status\n\nThe following conditions will _not_ change `modified_at`:\n\n- moving to a new container (project, portfolio, etc)\n- comments being added to the task (but the stories they generate\n  _will_ affect `modified_at`)",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "name": {
            "description": "Name of the task. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.",
            "example": "Buy catnip",
            "type": "string"
          },
          "notes": {
            "description": "Free-form textual information associated with the task (i.e. its description).",
            "example": "Mittens really likes the stuff from Humboldt.",
            "type": "string"
          },
          "num_hearts": {
            "description": "*Deprecated - please use likes instead* The number of users who have hearted this task.",
            "example": 5,
            "readOnly": true,
            "type": "integer"
          },
          "num_likes": {
            "description": "The number of users who have liked this task.",
            "example": 5,
            "readOnly": true,
            "type": "integer"
          },
          "num_subtasks": {
            "description": "[Opt In](/docs/inputoutput-options). The number of subtasks on this task.\n",
            "example": 3,
            "readOnly": true,
            "type": "integer"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe resource_subtype `milestone` represent a single moment in time. This means tasks with this subtype cannot have a start_date.",
            "enum": [
              "default_task",
              "milestone",
              "approval",
              "custom"
            ],
            "example": "default_task",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_at": {
            "description": "Date and time on which work begins for the task, or null if the task has no start time. This takes an ISO 8601 date string in UTC and should not be used together with `start_on`.\n*Note: `due_at` must be present in the request when setting or unsetting the `start_at` parameter.*",
            "example": "2019-09-14T02:06:58.147Z",
            "format": "date-time",
            "nullable": true,
            "type": "string"
          },
          "start_on": {
            "description": "The day on which work begins for the task , or null if the task has no start date. This takes a date with `YYYY-MM-DD` format and should not be used together with `start_at`.\n*Note: `due_on` or `due_at` must be present in the request when setting or unsetting the `start_on` parameter.*",
            "example": "2019-09-14",
            "format": "date",
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "task"
        }
      },
      "sdk__TaskCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe *task* is the basic object around which many operations in Asana are centered.",
        "properties": {
          "created_by": {
            "description": "[Opt In](/docs/inputoutput-options). A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource.",
                "example": "1111",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of resource.",
                "example": "user",
                "type": "string"
              }
            },
            "readOnly": true,
            "type": "object"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the task.",
            "example": "Bug Task",
            "type": "string"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe resource_subtype `milestone` represent a single moment in time. This means tasks with this subtype cannot have a start_date.",
            "enum": [
              "default_task",
              "milestone",
              "approval",
              "custom"
            ],
            "example": "default_task",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "task"
        }
      },
      "sdk__TaskCountResponse": {
        "description": "A response object returned from the task count endpoint.",
        "properties": {
          "num_completed_milestones": {
            "description": "The number of completed milestones in a project.",
            "example": 3,
            "type": "integer"
          },
          "num_completed_tasks": {
            "description": "The number of completed tasks in a project.",
            "example": 150,
            "type": "integer"
          },
          "num_incomplete_milestones": {
            "description": "The number of incomplete milestones in a project.",
            "example": 7,
            "type": "integer"
          },
          "num_incomplete_tasks": {
            "description": "The number of incomplete tasks in a project.",
            "example": 50,
            "type": "integer"
          },
          "num_milestones": {
            "description": "The number of milestones in a project.",
            "example": 10,
            "type": "integer"
          },
          "num_tasks": {
            "description": "The number of tasks in a project.",
            "example": 200,
            "type": "integer"
          }
        },
        "type": "object"
      },
      "sdk__TaskCountResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__TaskCountResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__TaskCreateRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe *task* is the basic object around which many operations in Asana are centered.",
        "properties": {
          "actual_time_minutes": {
            "description": "This value represents the sum of all the Time Tracking entries in the Actual Time field on a given Task. It is represented as a nullable long value.",
            "example": 200,
            "nullable": true,
            "readOnly": true,
            "type": "number"
          },
          "approval_status": {
            "description": "*Conditional* Reflects the approval status of this task. This field is kept in sync with `completed`, meaning `pending` translates to false while `approved`, `rejected`, and `changes_requested` translate to true. If you set completed to true, this field will be set to `approved`.",
            "enum": [
              "pending",
              "approved",
              "rejected",
              "changes_requested"
            ],
            "example": "pending",
            "type": "string"
          },
          "assigned_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.\nThe user who assigned the task. This field is only returned when requesting it via opt_fields, and will be null if the task has no specific assigner (e.g., tasks created without an explicit assigner).",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "assignee": {
            "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
            "example": "12345",
            "nullable": true,
            "readOnly": false,
            "type": "string",
            "x-env-variable": true
          },
          "assignee_section": {
            "description": "The *assignee section* is a subdivision of a project that groups tasks together in the assignee's \"My tasks\" list. It can either be a header above a list of tasks in a list view or a column in a board view of \"My tasks.\"\nThe `assignee_section` property will be returned in the response only if the request was sent by the user who is the assignee of the task. Note that you can only write to `assignee_section` with the gid of an existing section visible in the user's \"My tasks\" list.",
            "example": "12345",
            "nullable": true,
            "type": "string"
          },
          "assignee_status": {
            "description": "*Deprecated* Scheduling status of this task for the user it is assigned to. This field can only be set if the assignee is non-null. Setting this field to \"inbox\" or \"upcoming\" inserts it at the top of the section, while the other options will insert at the bottom.",
            "enum": [
              "today",
              "upcoming",
              "later",
              "new",
              "inbox"
            ],
            "example": "upcoming",
            "type": "string"
          },
          "completed": {
            "description": "True if the task is currently marked complete, false if not.",
            "example": false,
            "type": "boolean"
          },
          "completed_at": {
            "description": "The time at which this task was completed, or null if the task is incomplete.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "completed_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "created_by": {
            "description": "[Opt In](/docs/inputoutput-options). A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource.",
                "example": "1111",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of resource.",
                "example": "user",
                "type": "string"
              }
            },
            "readOnly": true,
            "type": "object"
          },
          "custom_fields": {
            "additionalProperties": {
              "description": "\"{custom_field_gid}\" => Value (can be text, a number, etc.). For date, use format \"YYYY-MM-DD\" (e.g., 2019-09-15). For date-time, use ISO 8601 date string in UTC (e.g., 2019-09-15T02:06:58.147Z).",
              "type": "string"
            },
            "description": "An object where each key is the GID of a custom field and its corresponding value is either an enum GID, string, number, object, or array (depending on the custom field type). See the [custom fields guide](/docs/custom-fields-guide) for details on creating and updating custom field values.",
            "example": {
              "4578152156": "Not Started",
              "5678904321": "On Hold"
            },
            "type": "object"
          },
          "custom_type": {
            "description": "*Conditional:* You can only set custom_type if task `resource_subtype` is `custom`. GID or globally-unique identifier of a task's custom type. The type must be valid for tasks, and some Asana-created custom types cannot be assigned via the API; attempting either returns an error explaining which condition failed.",
            "example": "12345",
            "nullable": true,
            "readOnly": false,
            "type": "string",
            "x-env-variable": true
          },
          "custom_type_status_option": {
            "description": "*Conditional:* You can only set custom_type_status_option if task `resource_subtype` is `custom` GID or globally-unique identifier of a custom type's status option.",
            "example": "12345",
            "nullable": true,
            "readOnly": false,
            "type": "string",
            "x-env-variable": true
          },
          "dependencies": {
            "description": "[Opt In](/docs/inputoutput-options). Array of resources referencing tasks that this task depends on. The objects contain only the gid of the dependency.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "dependents": {
            "description": "[Opt In](/docs/inputoutput-options). Array of resources referencing tasks that depend on this task. The objects contain only the ID of the dependent.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "due_at": {
            "description": "The UTC date and time on which this task is due, or null if the task has no due time. This takes an ISO 8601 date string in UTC and should not be used together with `due_on`.",
            "example": "2019-09-15T02:06:58.147Z",
            "format": "date-time",
            "nullable": true,
            "type": "string"
          },
          "due_on": {
            "description": "The localized date on which this task is due, or null if the task has no due date. This takes a date with `YYYY-MM-DD` format and should not be used together with `due_at`.",
            "example": "2019-09-15",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "external": {
            "description": "*OAuth Required*. *Conditional*. This field is returned only if external values are set or included by using [Opt In](/docs/inputoutput-options).\nThe external field allows you to store app-specific metadata on tasks, including a gid that can be used to retrieve tasks and a data blob that can store app-specific character strings. Note that you will need to authenticate with Oauth to access or modify this data. Once an external gid is set, you can use the notation `external:custom_gid` to reference your object anywhere in the API where you may use the original object gid. See the page on Custom External Data for more details.",
            "example": {
              "data": "A blob of information",
              "gid": "my_gid"
            },
            "properties": {
              "data": {
                "example": "A blob of information.",
                "type": "string"
              },
              "gid": {
                "example": "1234",
                "type": "string"
              }
            },
            "type": "object"
          },
          "followers": {
            "description": "*Create-Only* An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user. In order to change followers on an existing task use `addFollowers` and `removeFollowers`.",
            "example": [
              "12345"
            ],
            "items": {
              "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
              "type": "string"
            },
            "type": "array"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "has_subtasks_date_mismatch": {
            "description": "[Opt In](/docs/inputoutput-options). True when one or more descendant subtasks have dates outside the task's own date range. This field reflects the latest computed rollup state and returns false when no rollup has been computed.",
            "example": true,
            "readOnly": true,
            "type": "boolean"
          },
          "hearted": {
            "description": "*Deprecated - please use liked instead* True if the task is hearted by the authorized user, false if not.",
            "example": true,
            "readOnly": true,
            "type": "boolean"
          },
          "hearts": {
            "description": "*Deprecated - please use likes instead* Array of likes for users who have hearted this task.",
            "items": {
              "description": "An object to represent a user's like.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the object, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string"
                },
                "user": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "*Read-only except when same user as requester*. The user's name.",
                      "example": "Greg Sanchez",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "user"
                  }
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "html_custom_fields": {
            "additionalProperties": {
              "description": "\"{custom_field_gid}\" => HTML string (e.g., \"<body>Text content</body>\")",
              "type": "string"
            },
            "description": "An object where each key is the GID of a text custom field and the corresponding value is a rich text HTML string. Only text-type custom fields support this parameter. Values must be wrapped in <body></body> tags. See the [custom fields guide](/docs/custom-fields-guide) and [rich text](/docs/rich-text) for details on supported formatting.",
            "example": {
              "4578152156": "<body><code>Code block</code></body>",
              "5678904321": "<body><strong>Bold text</strong></body>"
            },
            "type": "object"
          },
          "html_notes": {
            "description": "[Opt In](/docs/inputoutput-options). The notes of the text with formatting as HTML. See [rich text](/docs/rich-text).",
            "example": "<body>Mittens <em>really</em> likes the stuff from Humboldt.</body>",
            "type": "string"
          },
          "is_rendered_as_separator": {
            "description": "[Opt In](/docs/inputoutput-options). In some contexts tasks can be rendered as a visual separator; for instance, subtasks can appear similar to [sections](/reference/sections) without being true `section` objects. If a `task` object is rendered this way in any context it will have the property `is_rendered_as_separator` set to `true`. This parameter only applies to regular tasks with `resource_subtype` of `default_task`. Tasks with `resource_subtype` of `milestone`, `approval`, or custom task types will not have this property and cannot be rendered as separators.",
            "example": false,
            "readOnly": true,
            "type": "boolean"
          },
          "liked": {
            "description": "True if the task is liked by the authorized user, false if not.",
            "example": true,
            "type": "boolean"
          },
          "likes": {
            "description": "Array of likes for users who have liked this task.",
            "items": {
              "description": "An object to represent a user's like.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the object, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string"
                },
                "user": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "*Read-only except when same user as requester*. The user's name.",
                      "example": "Greg Sanchez",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "user"
                  }
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "memberships": {
            "description": "*Create-only*. Array of projects this task is associated with and the section it is in. At task creation time, this array can be used to add the task to specific sections. After task creation, these associations can be modified using the `addProject` and `removeProject` endpoints. Note that over time, more types of memberships may be added to this property.",
            "items": {
              "properties": {
                "project": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "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.",
                      "example": "Stuff to buy",
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                      "enum": [
                        "default_project",
                        "custom"
                      ],
                      "example": "default_project",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "project"
                  }
                },
                "section": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *section* is a subdivision of a project that groups tasks together. It can either be a header above a list of tasks in a list view or a column in a board view of a project.",
                  "nullable": true,
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the section (i.e. the text displayed as the section header).",
                      "example": "Next Actions",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "section"
                  }
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "modified_at": {
            "description": "The time at which this task was last modified.\n\nThe following conditions will change `modified_at`:\n\n- story is created on a task\n- story is trashed on a task\n- attachment is trashed on a task\n- task is assigned or unassigned\n- custom field value is changed\n- the task itself is trashed\n- Or if any of the following fields are updated:\n  - completed\n  - name\n  - due_date\n  - description\n  - attachments\n  - items\n  - schedule_status\n\nThe following conditions will _not_ change `modified_at`:\n\n- moving to a new container (project, portfolio, etc)\n- comments being added to the task (but the stories they generate\n  _will_ affect `modified_at`)",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "name": {
            "description": "Name of the task. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.",
            "example": "Buy catnip",
            "type": "string"
          },
          "notes": {
            "description": "Free-form textual information associated with the task (i.e. its description).",
            "example": "Mittens really likes the stuff from Humboldt.",
            "type": "string"
          },
          "num_hearts": {
            "description": "*Deprecated - please use likes instead* The number of users who have hearted this task.",
            "example": 5,
            "readOnly": true,
            "type": "integer"
          },
          "num_likes": {
            "description": "The number of users who have liked this task.",
            "example": 5,
            "readOnly": true,
            "type": "integer"
          },
          "num_subtasks": {
            "description": "[Opt In](/docs/inputoutput-options). The number of subtasks on this task.\n",
            "example": 3,
            "readOnly": true,
            "type": "integer"
          },
          "parent": {
            "description": "Gid of a task.",
            "example": "12345",
            "nullable": true,
            "readOnly": false,
            "type": "string",
            "x-env-variable": true
          },
          "projects": {
            "description": "*Create-Only* Array of project gids. In order to change projects on an existing task use `addProject` and `removeProject`.",
            "example": [
              "12345"
            ],
            "items": {
              "description": "Gid of a project.",
              "type": "string"
            },
            "type": "array"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe resource_subtype `milestone` represent a single moment in time. This means tasks with this subtype cannot have a start_date.",
            "enum": [
              "default_task",
              "milestone",
              "approval",
              "custom"
            ],
            "example": "default_task",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_at": {
            "description": "Date and time on which work begins for the task, or null if the task has no start time. This takes an ISO 8601 date string in UTC and should not be used together with `start_on`.\n*Note: `due_at` must be present in the request when setting or unsetting the `start_at` parameter.*",
            "example": "2019-09-14T02:06:58.147Z",
            "format": "date-time",
            "nullable": true,
            "type": "string"
          },
          "start_on": {
            "description": "The day on which work begins for the task , or null if the task has no start date. This takes a date with `YYYY-MM-DD` format and should not be used together with `start_at`.\n*Note: `due_on` or `due_at` must be present in the request when setting or unsetting the `start_on` parameter.*",
            "example": "2019-09-14",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "tags": {
            "description": "*Create-Only* Array of tag gids. In order to change tags on an existing task use `addTag` and `removeTag`.",
            "example": [
              "12345"
            ],
            "items": {
              "description": "Gid of a tag.",
              "type": "string"
            },
            "type": "array"
          },
          "workspace": {
            "description": "Gid of a workspace.",
            "example": "12345",
            "readOnly": false,
            "type": "string",
            "x-env-variable": true
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "task"
        }
      },
      "sdk__TaskDuplicateRequest": {
        "properties": {
          "include": {
            "description": "A comma-separated list of fields that will be duplicated to the new task.\n##### Fields\n- assignee\n- attachments\n- dates\n- dependencies\n- followers\n- notes\n- parent\n- projects\n- subtasks\n- tags",
            "example": [
              "notes,assignee,subtasks,attachments,tags,followers,projects,dates,dependencies,parent"
            ],
            "pattern": "([notes|assignee|subtasks|attachments|tags|followers|projects|dates|dependencies|parent])(,\\1)*",
            "type": "string"
          },
          "name": {
            "description": "The name of the new task.",
            "example": "New Task Name",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__TaskMembership": {
        "properties": {
          "project": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          "section": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *section* is a subdivision of a project that groups tasks together. It can either be a header above a list of tasks in a list view or a column in a board view of a project.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the section (i.e. the text displayed as the section header).",
                "example": "Next Actions",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "section"
            }
          }
        },
        "type": "object"
      },
      "sdk__TaskRemoveFollowersRequest": {
        "properties": {
          "followers": {
            "description": "An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user.",
            "example": [
              "13579",
              "321654"
            ],
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "followers"
        ],
        "type": "object"
      },
      "sdk__TaskRemoveProjectRequest": {
        "properties": {
          "project": {
            "description": "The project to remove the task from.",
            "example": "13579",
            "type": "string"
          }
        },
        "required": [
          "project"
        ],
        "type": "object"
      },
      "sdk__TaskRemoveTagRequest": {
        "properties": {
          "tag": {
            "description": "The tag's gid to remove from the task.",
            "example": "13579",
            "type": "string"
          }
        },
        "required": [
          "tag"
        ],
        "type": "object"
      },
      "sdk__TaskRequestBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe *task* is the basic object around which many operations in Asana are centered.",
        "properties": {
          "actual_time_minutes": {
            "description": "This value represents the sum of all the Time Tracking entries in the Actual Time field on a given Task. It is represented as a nullable long value.",
            "example": 200,
            "nullable": true,
            "readOnly": true,
            "type": "number"
          },
          "approval_status": {
            "description": "*Conditional* Reflects the approval status of this task. This field is kept in sync with `completed`, meaning `pending` translates to false while `approved`, `rejected`, and `changes_requested` translate to true. If you set completed to true, this field will be set to `approved`.",
            "enum": [
              "pending",
              "approved",
              "rejected",
              "changes_requested"
            ],
            "example": "pending",
            "type": "string"
          },
          "assigned_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.\nThe user who assigned the task. This field is only returned when requesting it via opt_fields, and will be null if the task has no specific assigner (e.g., tasks created without an explicit assigner).",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "assignee": {
            "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
            "example": "12345",
            "nullable": true,
            "readOnly": false,
            "type": "string",
            "x-env-variable": true
          },
          "assignee_section": {
            "description": "The *assignee section* is a subdivision of a project that groups tasks together in the assignee's \"My tasks\" list. It can either be a header above a list of tasks in a list view or a column in a board view of \"My tasks.\"\nThe `assignee_section` property will be returned in the response only if the request was sent by the user who is the assignee of the task. Note that you can only write to `assignee_section` with the gid of an existing section visible in the user's \"My tasks\" list.",
            "example": "12345",
            "nullable": true,
            "type": "string"
          },
          "assignee_status": {
            "description": "*Deprecated* Scheduling status of this task for the user it is assigned to. This field can only be set if the assignee is non-null. Setting this field to \"inbox\" or \"upcoming\" inserts it at the top of the section, while the other options will insert at the bottom.",
            "enum": [
              "today",
              "upcoming",
              "later",
              "new",
              "inbox"
            ],
            "example": "upcoming",
            "type": "string"
          },
          "completed": {
            "description": "True if the task is currently marked complete, false if not.",
            "example": false,
            "type": "boolean"
          },
          "completed_at": {
            "description": "The time at which this task was completed, or null if the task is incomplete.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "completed_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "created_by": {
            "description": "[Opt In](/docs/inputoutput-options). A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource.",
                "example": "1111",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of resource.",
                "example": "user",
                "type": "string"
              }
            },
            "readOnly": true,
            "type": "object"
          },
          "custom_fields": {
            "additionalProperties": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "number"
                },
                {
                  "type": "object"
                },
                {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                }
              ],
              "description": "\"{custom_field_gid}\" => Value (can be text, a number, etc.). For date, use format \"YYYY-MM-DD\" (e.g., 2019-09-15). For date-time, use ISO 8601 date string in UTC (e.g., 2019-09-15T02:06:58.147Z).",
              "nullable": true
            },
            "description": "An object where each key is the GID of a custom field and its corresponding value is either an enum GID, string, number, object, or array (depending on the custom field type). See the [custom fields guide](/docs/custom-fields-guide) for details on creating and updating custom field values.",
            "example": {
              "4578152156": "Not Started",
              "5678904321": "On Hold"
            },
            "type": "object"
          },
          "custom_type": {
            "description": "*Conditional:* You can only set custom_type if task `resource_subtype` is `custom`. GID or globally-unique identifier of a task's custom type. The type must be valid for tasks, and some Asana-created custom types cannot be assigned via the API; attempting either returns an error explaining which condition failed.",
            "example": "12345",
            "nullable": true,
            "readOnly": false,
            "type": "string",
            "x-env-variable": true
          },
          "custom_type_status_option": {
            "description": "*Conditional:* You can only set custom_type_status_option if task `resource_subtype` is `custom` GID or globally-unique identifier of a custom type's status option.",
            "example": "12345",
            "nullable": true,
            "readOnly": false,
            "type": "string",
            "x-env-variable": true
          },
          "dependencies": {
            "description": "[Opt In](/docs/inputoutput-options). Array of resources referencing tasks that this task depends on. The objects contain only the gid of the dependency.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "dependents": {
            "description": "[Opt In](/docs/inputoutput-options). Array of resources referencing tasks that depend on this task. The objects contain only the ID of the dependent.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "due_at": {
            "description": "The UTC date and time on which this task is due, or null if the task has no due time. This takes an ISO 8601 date string in UTC and should not be used together with `due_on`.",
            "example": "2019-09-15T02:06:58.147Z",
            "format": "date-time",
            "nullable": true,
            "type": "string"
          },
          "due_on": {
            "description": "The localized date on which this task is due, or null if the task has no due date. This takes a date with `YYYY-MM-DD` format and should not be used together with `due_at`.",
            "example": "2019-09-15",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "external": {
            "description": "*OAuth Required*. *Conditional*. This field is returned only if external values are set or included by using [Opt In](/docs/inputoutput-options).\nThe external field allows you to store app-specific metadata on tasks, including a gid that can be used to retrieve tasks and a data blob that can store app-specific character strings. Note that you will need to authenticate with Oauth to access or modify this data. Once an external gid is set, you can use the notation `external:custom_gid` to reference your object anywhere in the API where you may use the original object gid. See the page on Custom External Data for more details.",
            "example": {
              "data": "A blob of information",
              "gid": "my_gid"
            },
            "properties": {
              "data": {
                "example": "A blob of information.",
                "type": "string"
              },
              "gid": {
                "example": "1234",
                "type": "string"
              }
            },
            "type": "object"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "has_subtasks_date_mismatch": {
            "description": "[Opt In](/docs/inputoutput-options). True when one or more descendant subtasks have dates outside the task's own date range. This field reflects the latest computed rollup state and returns false when no rollup has been computed.",
            "example": true,
            "readOnly": true,
            "type": "boolean"
          },
          "hearted": {
            "description": "*Deprecated - please use liked instead* True if the task is hearted by the authorized user, false if not.",
            "example": true,
            "readOnly": true,
            "type": "boolean"
          },
          "hearts": {
            "description": "*Deprecated - please use likes instead* Array of likes for users who have hearted this task.",
            "items": {
              "description": "An object to represent a user's like.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the object, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string"
                },
                "user": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "*Read-only except when same user as requester*. The user's name.",
                      "example": "Greg Sanchez",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "user"
                  }
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "html_custom_fields": {
            "additionalProperties": {
              "description": "\"{custom_field_gid}\" => HTML string (e.g., \"<body>Text content</body>\")",
              "type": "string"
            },
            "description": "An object where each key is the GID of a text custom field and the corresponding value is a rich text HTML string. Only text-type custom fields support this parameter. Values must be wrapped in <body></body> tags. See the [custom fields guide](/docs/custom-fields-guide) and [rich text](/docs/rich-text) for details on supported formatting.",
            "example": {
              "4578152156": "<body><code>Code block</code></body>",
              "5678904321": "<body><strong>Bold text</strong></body>"
            },
            "type": "object"
          },
          "html_notes": {
            "description": "[Opt In](/docs/inputoutput-options). The notes of the text with formatting as HTML. See [rich text](/docs/rich-text).",
            "example": "<body>Mittens <em>really</em> likes the stuff from Humboldt.</body>",
            "type": "string"
          },
          "is_rendered_as_separator": {
            "description": "[Opt In](/docs/inputoutput-options). In some contexts tasks can be rendered as a visual separator; for instance, subtasks can appear similar to [sections](/reference/sections) without being true `section` objects. If a `task` object is rendered this way in any context it will have the property `is_rendered_as_separator` set to `true`. This parameter only applies to regular tasks with `resource_subtype` of `default_task`. Tasks with `resource_subtype` of `milestone`, `approval`, or custom task types will not have this property and cannot be rendered as separators.",
            "example": false,
            "readOnly": true,
            "type": "boolean"
          },
          "liked": {
            "description": "True if the task is liked by the authorized user, false if not.",
            "example": true,
            "type": "boolean"
          },
          "likes": {
            "description": "Array of likes for users who have liked this task.",
            "items": {
              "description": "An object to represent a user's like.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the object, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string"
                },
                "user": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "*Read-only except when same user as requester*. The user's name.",
                      "example": "Greg Sanchez",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "user"
                  }
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "memberships": {
            "description": "*Create-only*. Array of projects this task is associated with and the section it is in. At task creation time, this array can be used to add the task to specific sections. After task creation, these associations can be modified using the `addProject` and `removeProject` endpoints. Note that over time, more types of memberships may be added to this property.",
            "items": {
              "properties": {
                "project": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "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.",
                      "example": "Stuff to buy",
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                      "enum": [
                        "default_project",
                        "custom"
                      ],
                      "example": "default_project",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "project"
                  }
                },
                "section": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *section* is a subdivision of a project that groups tasks together. It can either be a header above a list of tasks in a list view or a column in a board view of a project.",
                  "nullable": true,
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the section (i.e. the text displayed as the section header).",
                      "example": "Next Actions",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "section"
                  }
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "modified_at": {
            "description": "The time at which this task was last modified.\n\nThe following conditions will change `modified_at`:\n\n- story is created on a task\n- story is trashed on a task\n- attachment is trashed on a task\n- task is assigned or unassigned\n- custom field value is changed\n- the task itself is trashed\n- Or if any of the following fields are updated:\n  - completed\n  - name\n  - due_date\n  - description\n  - attachments\n  - items\n  - schedule_status\n\nThe following conditions will _not_ change `modified_at`:\n\n- moving to a new container (project, portfolio, etc)\n- comments being added to the task (but the stories they generate\n  _will_ affect `modified_at`)",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "name": {
            "description": "Name of the task. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.",
            "example": "Buy catnip",
            "type": "string"
          },
          "notes": {
            "description": "Free-form textual information associated with the task (i.e. its description).",
            "example": "Mittens really likes the stuff from Humboldt.",
            "type": "string"
          },
          "num_hearts": {
            "description": "*Deprecated - please use likes instead* The number of users who have hearted this task.",
            "example": 5,
            "readOnly": true,
            "type": "integer"
          },
          "num_likes": {
            "description": "The number of users who have liked this task.",
            "example": 5,
            "readOnly": true,
            "type": "integer"
          },
          "num_subtasks": {
            "description": "[Opt In](/docs/inputoutput-options). The number of subtasks on this task.\n",
            "example": 3,
            "readOnly": true,
            "type": "integer"
          },
          "parent": {
            "description": "Gid of a task.",
            "example": "12345",
            "nullable": true,
            "readOnly": false,
            "type": "string",
            "x-env-variable": true
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe resource_subtype `milestone` represent a single moment in time. This means tasks with this subtype cannot have a start_date.",
            "enum": [
              "default_task",
              "milestone",
              "approval",
              "custom"
            ],
            "example": "default_task",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_at": {
            "description": "Date and time on which work begins for the task, or null if the task has no start time. This takes an ISO 8601 date string in UTC and should not be used together with `start_on`.\n*Note: `due_at` must be present in the request when setting or unsetting the `start_at` parameter.*",
            "example": "2019-09-14T02:06:58.147Z",
            "format": "date-time",
            "nullable": true,
            "type": "string"
          },
          "start_on": {
            "description": "The day on which work begins for the task , or null if the task has no start date. This takes a date with `YYYY-MM-DD` format and should not be used together with `start_at`.\n*Note: `due_on` or `due_at` must be present in the request when setting or unsetting the `start_on` parameter.*",
            "example": "2019-09-14",
            "format": "date",
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "task"
        }
      },
      "sdk__TaskResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe *task* is the basic object around which many operations in Asana are centered.",
        "properties": {
          "actual_time_minutes": {
            "description": "This value represents the sum of all the Time Tracking entries in the Actual Time field on a given Task. It is represented as a nullable long value.",
            "example": 200,
            "nullable": true,
            "readOnly": true,
            "type": "number"
          },
          "approval_status": {
            "description": "*Conditional* Reflects the approval status of this task. This field is kept in sync with `completed`, meaning `pending` translates to false while `approved`, `rejected`, and `changes_requested` translate to true. If you set completed to true, this field will be set to `approved`.",
            "enum": [
              "pending",
              "approved",
              "rejected",
              "changes_requested"
            ],
            "example": "pending",
            "type": "string"
          },
          "assigned_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.\nThe user who assigned the task. This field is only returned when requesting it via opt_fields, and will be null if the task has no specific assigner (e.g., tasks created without an explicit assigner).",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "assignee": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "assignee_section": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *section* is a subdivision of a project that groups tasks together. It can either be a header above a list of tasks in a list view or a column in a board view of a project.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *section* is a subdivision of a project that groups tasks together. It can either be a header above a list of tasks in a list view or a column in a board view of a project.\nThe *assignee section* is a subdivision of a project that groups tasks together in the assignee's \"My tasks\" list. It can either be a header above a list of tasks in a list view or a column in a board view of \"My tasks.\"\nThe `assignee_section` property will be returned in the response only if the request was sent by the user who is the assignee of the task. Note that you can only write to `assignee_section` with the gid of an existing section visible in the user's \"My tasks\" list.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the section (i.e. the text displayed as the section header).",
                "example": "Next Actions",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "section"
            }
          },
          "assignee_status": {
            "description": "*Deprecated* Scheduling status of this task for the user it is assigned to. This field can only be set if the assignee is non-null. Setting this field to \"inbox\" or \"upcoming\" inserts it at the top of the section, while the other options will insert at the bottom.",
            "enum": [
              "today",
              "upcoming",
              "later",
              "new",
              "inbox"
            ],
            "example": "upcoming",
            "type": "string"
          },
          "completed": {
            "description": "True if the task is currently marked complete, false if not.",
            "example": false,
            "type": "boolean"
          },
          "completed_at": {
            "description": "The time at which this task was completed, or null if the task is incomplete.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "completed_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "created_by": {
            "description": "[Opt In](/docs/inputoutput-options). A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource.",
                "example": "1111",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of resource.",
                "example": "user",
                "type": "string"
              }
            },
            "readOnly": true,
            "type": "object"
          },
          "custom_fields": {
            "description": "Array of custom field values applied to the task. These represent the custom field values recorded on this project for a particular custom field. For example, these custom field values will contain an `enum_value` property for custom fields of type `enum`, a `text_value` property for custom fields of type `text`, and so on. Please note that the `gid` returned on each custom field value *is identical* to the `gid` of the custom field, which allows referencing the custom field metadata through the `/custom_fields/custom_field_gid` endpoint. The array includes custom fields from projects the task belongs to directly and from projects inherited from its full ancestor chain.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.",
              "properties": {
                "asana_created_field": {
                  "description": "*Conditional*. A unique identifier to associate this field with the template source of truth.",
                  "enum": [
                    "a_v_requirements",
                    "account_name",
                    "actionable",
                    "align_shipping_link",
                    "align_status",
                    "allotted_time",
                    "appointment",
                    "approval_stage",
                    "approved",
                    "article_series",
                    "board_committee",
                    "browser",
                    "campaign_audience",
                    "campaign_project_status",
                    "campaign_regions",
                    "channel_primary",
                    "client_topic_type",
                    "complete_by",
                    "contact",
                    "contact_email_address",
                    "content_channels",
                    "content_channels_needed",
                    "content_stage",
                    "content_type",
                    "contract",
                    "contract_status",
                    "cost",
                    "creation_stage",
                    "creative_channel",
                    "creative_needed",
                    "creative_needs",
                    "data_sensitivity",
                    "deal_size",
                    "delivery_appt",
                    "delivery_appt_date",
                    "department",
                    "department_responsible",
                    "design_request_needed",
                    "design_request_type",
                    "discussion_category",
                    "do_this_task",
                    "editorial_content_status",
                    "editorial_content_tag",
                    "editorial_content_type",
                    "effort",
                    "effort_level",
                    "est_completion_date",
                    "estimated_time",
                    "estimated_value",
                    "expected_cost",
                    "external_steps_needed",
                    "favorite_idea",
                    "feedback_type",
                    "financial",
                    "funding_amount",
                    "grant_application_process",
                    "hiring_candidate_status",
                    "idea_status",
                    "ids_link",
                    "ids_patient_link",
                    "implementation_stage",
                    "insurance",
                    "interview_area",
                    "interview_question_score",
                    "itero_scan_link",
                    "job_s_applied_to",
                    "lab",
                    "launch_status",
                    "lead_status",
                    "localization_language",
                    "localization_market_team",
                    "localization_status",
                    "meeting_minutes",
                    "meeting_needed",
                    "minutes",
                    "mrr",
                    "must_localize",
                    "name_of_foundation",
                    "need_to_follow_up",
                    "next_appointment",
                    "next_steps_sales",
                    "num_people",
                    "number_of_user_reports",
                    "office_location",
                    "onboarding_activity",
                    "owner",
                    "participants_needed",
                    "patient_date_of_birth",
                    "patient_email",
                    "patient_phone",
                    "patient_status",
                    "phone_number",
                    "planning_category",
                    "point_of_contact",
                    "position",
                    "post_format",
                    "prescription",
                    "priority",
                    "priority_level",
                    "product",
                    "product_stage",
                    "progress",
                    "project_size",
                    "project_status",
                    "proposed_budget",
                    "publish_status",
                    "reason_for_scan",
                    "referral",
                    "request_type",
                    "research_status",
                    "responsible_department",
                    "responsible_team",
                    "risk_assessment_status",
                    "room_name",
                    "sales_counterpart",
                    "sentiment",
                    "shipping_link",
                    "social_channels",
                    "stage",
                    "status",
                    "status_design",
                    "status_of_initiative",
                    "system_setup",
                    "task_progress",
                    "team",
                    "team_marketing",
                    "team_responsible",
                    "time_it_takes_to_complete_tasks",
                    "timeframe",
                    "treatment_type",
                    "type_work_requests_it",
                    "use_agency",
                    "user_name",
                    "vendor_category",
                    "vendor_type",
                    "word_count",
                    null
                  ],
                  "example": "priority",
                  "nullable": true,
                  "readOnly": true,
                  "type": "string"
                },
                "created_by": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                  "nullable": true,
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "*Read-only except when same user as requester*. The user's name.",
                      "example": "Greg Sanchez",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "user"
                  }
                },
                "currency_code": {
                  "description": "ISO 4217 currency code to format this custom field. This will be null if the `format` is not `currency`.",
                  "example": "EUR",
                  "nullable": true,
                  "type": "string"
                },
                "custom_label": {
                  "description": "This is the string that appears next to the custom field value. This will be null if the `format` is not `custom`.",
                  "example": "gold pieces",
                  "nullable": true,
                  "type": "string"
                },
                "custom_label_position": {
                  "description": "Only relevant for custom fields with `custom` format. This depicts where to place the custom label. This will be null if the `format` is not `custom`.",
                  "enum": [
                    "prefix",
                    "suffix",
                    null
                  ],
                  "example": "suffix",
                  "nullable": true,
                  "type": "string"
                },
                "date_value": {
                  "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                  "nullable": true,
                  "properties": {
                    "date": {
                      "description": "A string representing the date in YYYY-MM-DD format.",
                      "example": "2024-08-23",
                      "type": "string"
                    },
                    "date_time": {
                      "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                      "example": "2024-08-23T22:00:00.000Z",
                      "type": "string"
                    }
                  },
                  "type": "object"
                },
                "default_access_level": {
                  "description": "The default access level when inviting new members to the custom field. This isn't applied when the `privacy_setting` is `private`, or the user is a guest. For local fields in a project or portfolio, the user must additionally have permission to modify the container itself.",
                  "enum": [
                    "admin",
                    "editor",
                    "user"
                  ],
                  "example": "user",
                  "type": "string"
                },
                "description": {
                  "description": "[Opt In](/docs/inputoutput-options). The description of the custom field.",
                  "example": "Development team priority",
                  "type": "string"
                },
                "display_value": {
                  "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                  "example": "blue",
                  "nullable": true,
                  "readOnly": true,
                  "type": "string"
                },
                "enabled": {
                  "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                  "example": true,
                  "readOnly": true,
                  "type": "boolean"
                },
                "enum_options": {
                  "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                  "items": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                    "properties": {
                      "color": {
                        "description": "The color of the enum option. Defaults to `none`.",
                        "example": "blue",
                        "type": "string"
                      },
                      "enabled": {
                        "description": "Whether or not the enum option is a selectable value for the custom field.",
                        "example": true,
                        "type": "boolean"
                      },
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "The name of the enum option.",
                        "example": "Low",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "enum_option"
                    }
                  },
                  "type": "array"
                },
                "enum_value": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                  "nullable": true,
                  "properties": {
                    "color": {
                      "description": "The color of the enum option. Defaults to `none`.",
                      "example": "blue",
                      "type": "string"
                    },
                    "enabled": {
                      "description": "Whether or not the enum option is a selectable value for the custom field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the enum option.",
                      "example": "Low",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "enum_option"
                  }
                },
                "format": {
                  "description": "The format of this custom field.",
                  "enum": [
                    "currency",
                    "identifier",
                    "percentage",
                    "custom",
                    "duration",
                    "none"
                  ],
                  "example": "custom",
                  "type": "string"
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "has_notifications_enabled": {
                  "description": "*Conditional*. This flag describes whether a follower of a task with this field should receive inbox notifications from changes to this field.",
                  "example": true,
                  "type": "boolean"
                },
                "html_text_value": {
                  "description": "*Conditional*. Only relevant for custom fields of type `text`. This is the HTML representation of the text value of a custom field, corresponding to the `text_value` plain-text field. See [rich text](/docs/rich-text#reading-rich-text).",
                  "example": "<body>Some Value</body>",
                  "nullable": true,
                  "readOnly": true,
                  "type": "string"
                },
                "id_prefix": {
                  "description": "This field is the unique custom ID string for the custom field.",
                  "example": "ID",
                  "nullable": true,
                  "type": "string"
                },
                "input_restrictions": {
                  "example": [
                    "task"
                  ],
                  "items": {
                    "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                    "enum": [
                      "task",
                      "project",
                      "portfolio",
                      "goal"
                    ],
                    "type": "string"
                  },
                  "type": "array"
                },
                "is_formula_field": {
                  "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                  "example": false,
                  "type": "boolean"
                },
                "is_global_to_workspace": {
                  "description": "This flag describes whether this custom field is available to every container in the workspace. Before project-specific custom fields, this field was always true.",
                  "example": true,
                  "readOnly": true,
                  "type": "boolean"
                },
                "is_lookup_field": {
                  "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                  "example": false,
                  "type": "boolean"
                },
                "is_value_read_only": {
                  "description": "*Conditional*. This flag describes whether a custom field is read only.",
                  "example": false,
                  "type": "boolean"
                },
                "multi_enum_values": {
                  "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                  "items": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                    "properties": {
                      "color": {
                        "description": "The color of the enum option. Defaults to `none`.",
                        "example": "blue",
                        "type": "string"
                      },
                      "enabled": {
                        "description": "Whether or not the enum option is a selectable value for the custom field.",
                        "example": true,
                        "type": "boolean"
                      },
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "The name of the enum option.",
                        "example": "Low",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "enum_option"
                    }
                  },
                  "type": "array"
                },
                "name": {
                  "description": "The name of the custom field.",
                  "example": "Status",
                  "type": "string"
                },
                "number_value": {
                  "description": "*Conditional*. This number is the value of a `number` custom field.",
                  "example": 5.2,
                  "nullable": true,
                  "type": "number"
                },
                "people_value": {
                  "description": "*Conditional*. Only relevant for custom fields of type `people`. This array of [compact user](/reference/users) objects reflects the values of a `people` custom field.",
                  "items": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                    "properties": {
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "*Read-only except when same user as requester*. The user's name.",
                        "example": "Greg Sanchez",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "user"
                    }
                  },
                  "type": "array"
                },
                "precision": {
                  "description": "Only relevant for custom fields of type `Number`. This field dictates the number of places after the decimal to round to, i.e. 0 is integer values, 1 rounds to the nearest tenth, and so on. Must be between 0 and 6, inclusive.\nFor percentage format, this may be unintuitive, as a value of 0.25 has a precision of 0, while a value of 0.251 has a precision of 1. This is due to 0.25 being displayed as 25%.\nThe identifier format will always have a precision of 0.",
                  "example": 2,
                  "type": "integer"
                },
                "privacy_setting": {
                  "description": "The privacy setting of the custom field. *Note: Administrators in your organization may restrict the values of `privacy_setting`.*",
                  "enum": [
                    "public_with_guests",
                    "public",
                    "private"
                  ],
                  "example": "public_with_guests",
                  "type": "string"
                },
                "reference_value": {
                  "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of objects reflects the values of a `reference` custom field.",
                  "items": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.",
                    "properties": {
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "The name of the object.",
                        "example": "Bug Task",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object"
                  },
                  "type": "array"
                },
                "representation_type": {
                  "description": "This field tells the type of the custom field.",
                  "enum": [
                    "text",
                    "enum",
                    "multi_enum",
                    "number",
                    "date",
                    "people",
                    "formula",
                    "custom_id",
                    "reference"
                  ],
                  "example": "number",
                  "readOnly": true,
                  "type": "string"
                },
                "resource_subtype": {
                  "description": "The type of the custom field. Must be one of the given values.\n",
                  "enum": [
                    "text",
                    "enum",
                    "multi_enum",
                    "number",
                    "date",
                    "people",
                    "reference"
                  ],
                  "example": "text",
                  "readOnly": true,
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                },
                "text_value": {
                  "description": "*Conditional*. This string is the value of a `text` custom field.",
                  "example": "Some Value",
                  "nullable": true,
                  "type": "string"
                },
                "type": {
                  "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                  "enum": [
                    "text",
                    "enum",
                    "multi_enum",
                    "number",
                    "date",
                    "people",
                    "reference"
                  ],
                  "readOnly": true,
                  "type": "string"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "custom_field"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "custom_type": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Types extend the types of Asana Objects.",
            "nullable": true,
            "properties": {
              "asana_created_type_identifier": {
                "description": "*Read-only*. A stable identifier present when this custom type was created by Asana as part of an Asana product (for example, a Command ticket type or a Service queue type). `null` for custom types created by users, and for Asana-created types that do not have a public identifier yet. New values may be added over time as Asana products introduce new types; integrations should tolerate unrecognized values.",
                "enum": [
                  "COMMAND_TICKET",
                  "COMMAND_RELEASE",
                  "COMMAND_TEAMSPACE",
                  "SERVICE_TICKET",
                  "SERVICE_CONVERSATION",
                  "SERVICE_QUEUE"
                ],
                "example": "COMMAND_TICKET",
                "nullable": true,
                "readOnly": true,
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the custom type.",
                "example": "Bug ticket",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "custom_type"
            }
          },
          "custom_type_status_option": {
            "description": "A generic Asana Resource, containing a globally unique identifier.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the custom type status option.",
                "example": "Solution pending",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "custom_type_status_option"
            }
          },
          "dependencies": {
            "description": "[Opt In](/docs/inputoutput-options). Array of resources referencing tasks that this task depends on. The objects contain only the gid of the dependency.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "dependents": {
            "description": "[Opt In](/docs/inputoutput-options). Array of resources referencing tasks that depend on this task. The objects contain only the ID of the dependent.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "due_at": {
            "description": "The UTC date and time on which this task is due, or null if the task has no due time. This takes an ISO 8601 date string in UTC and should not be used together with `due_on`.",
            "example": "2019-09-15T02:06:58.147Z",
            "format": "date-time",
            "nullable": true,
            "type": "string"
          },
          "due_on": {
            "description": "The localized date on which this task is due, or null if the task has no due date. This takes a date with `YYYY-MM-DD` format and should not be used together with `due_at`.",
            "example": "2019-09-15",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "effective_memberships": {
            "description": "Opt-in, read-only. The union of direct and inherited memberships for this task. If the task is both directly associated with and inherits the same project, the direct membership takes precedence.",
            "items": {
              "allOf": [
                {
                  "properties": {
                    "project": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
                      "properties": {
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "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.",
                          "example": "Stuff to buy",
                          "type": "string"
                        },
                        "resource_subtype": {
                          "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                          "enum": [
                            "default_project",
                            "custom"
                          ],
                          "example": "default_project",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "project"
                      }
                    },
                    "section": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *section* is a subdivision of a project that groups tasks together. It can either be a header above a list of tasks in a list view or a column in a board view of a project.",
                      "nullable": true,
                      "properties": {
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "The name of the section (i.e. the text displayed as the section header).",
                          "example": "Next Actions",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "section"
                      }
                    }
                  },
                  "type": "object"
                },
                {
                  "properties": {
                    "is_inherited": {
                      "description": "Whether this membership is inherited from an ancestor task (`true`) or is a direct membership (`false`).",
                      "example": false,
                      "type": "boolean"
                    }
                  },
                  "type": "object"
                }
              ],
              "description": "A task's project membership, indicating whether the membership is direct or inherited from an ancestor task."
            },
            "readOnly": true,
            "type": "array"
          },
          "external": {
            "description": "*OAuth Required*. *Conditional*. This field is returned only if external values are set or included by using [Opt In](/docs/inputoutput-options).\nThe external field allows you to store app-specific metadata on tasks, including a gid that can be used to retrieve tasks and a data blob that can store app-specific character strings. Note that you will need to authenticate with Oauth to access or modify this data. Once an external gid is set, you can use the notation `external:custom_gid` to reference your object anywhere in the API where you may use the original object gid. See the page on Custom External Data for more details.",
            "example": {
              "data": "A blob of information",
              "gid": "my_gid"
            },
            "properties": {
              "data": {
                "example": "A blob of information.",
                "type": "string"
              },
              "gid": {
                "example": "1234",
                "type": "string"
              }
            },
            "type": "object"
          },
          "followers": {
            "description": "Array of users following this task.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "*Read-only except when same user as requester*. The user's name.",
                  "example": "Greg Sanchez",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "user"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "has_subtasks_date_mismatch": {
            "description": "[Opt In](/docs/inputoutput-options). True when one or more descendant subtasks have dates outside the task's own date range. This field reflects the latest computed rollup state and returns false when no rollup has been computed.",
            "example": true,
            "readOnly": true,
            "type": "boolean"
          },
          "hearted": {
            "description": "*Deprecated - please use liked instead* True if the task is hearted by the authorized user, false if not.",
            "example": true,
            "readOnly": true,
            "type": "boolean"
          },
          "hearts": {
            "description": "*Deprecated - please use likes instead* Array of likes for users who have hearted this task.",
            "items": {
              "description": "An object to represent a user's like.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the object, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string"
                },
                "user": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "*Read-only except when same user as requester*. The user's name.",
                      "example": "Greg Sanchez",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "user"
                  }
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "html_notes": {
            "description": "[Opt In](/docs/inputoutput-options). The notes of the text with formatting as HTML. See [rich text](/docs/rich-text).",
            "example": "<body>Mittens <em>really</em> likes the stuff from Humboldt.</body>",
            "type": "string"
          },
          "is_rendered_as_separator": {
            "description": "[Opt In](/docs/inputoutput-options). In some contexts tasks can be rendered as a visual separator; for instance, subtasks can appear similar to [sections](/reference/sections) without being true `section` objects. If a `task` object is rendered this way in any context it will have the property `is_rendered_as_separator` set to `true`. This parameter only applies to regular tasks with `resource_subtype` of `default_task`. Tasks with `resource_subtype` of `milestone`, `approval`, or custom task types will not have this property and cannot be rendered as separators.",
            "example": false,
            "readOnly": true,
            "type": "boolean"
          },
          "liked": {
            "description": "True if the task is liked by the authorized user, false if not.",
            "example": true,
            "type": "boolean"
          },
          "likes": {
            "description": "Array of likes for users who have liked this task.",
            "items": {
              "description": "An object to represent a user's like.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the object, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string"
                },
                "user": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "*Read-only except when same user as requester*. The user's name.",
                      "example": "Greg Sanchez",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "user"
                  }
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "memberships": {
            "description": "*Create-only*. Array of projects this task is associated with and the section it is in. At task creation time, this array can be used to add the task to specific sections. After task creation, these associations can be modified using the `addProject` and `removeProject` endpoints. Note that over time, more types of memberships may be added to this property.",
            "items": {
              "properties": {
                "project": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "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.",
                      "example": "Stuff to buy",
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                      "enum": [
                        "default_project",
                        "custom"
                      ],
                      "example": "default_project",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "project"
                  }
                },
                "section": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *section* is a subdivision of a project that groups tasks together. It can either be a header above a list of tasks in a list view or a column in a board view of a project.",
                  "nullable": true,
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the section (i.e. the text displayed as the section header).",
                      "example": "Next Actions",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "section"
                  }
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "modified_at": {
            "description": "The time at which this task was last modified.\n\nThe following conditions will change `modified_at`:\n\n- story is created on a task\n- story is trashed on a task\n- attachment is trashed on a task\n- task is assigned or unassigned\n- custom field value is changed\n- the task itself is trashed\n- Or if any of the following fields are updated:\n  - completed\n  - name\n  - due_date\n  - description\n  - attachments\n  - items\n  - schedule_status\n\nThe following conditions will _not_ change `modified_at`:\n\n- moving to a new container (project, portfolio, etc)\n- comments being added to the task (but the stories they generate\n  _will_ affect `modified_at`)",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "name": {
            "description": "Name of the task. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.",
            "example": "Buy catnip",
            "type": "string"
          },
          "notes": {
            "description": "Free-form textual information associated with the task (i.e. its description).",
            "example": "Mittens really likes the stuff from Humboldt.",
            "type": "string"
          },
          "num_hearts": {
            "description": "*Deprecated - please use likes instead* The number of users who have hearted this task.",
            "example": 5,
            "readOnly": true,
            "type": "integer"
          },
          "num_likes": {
            "description": "The number of users who have liked this task.",
            "example": 5,
            "readOnly": true,
            "type": "integer"
          },
          "num_subtasks": {
            "description": "[Opt In](/docs/inputoutput-options). The number of subtasks on this task.\n",
            "example": 3,
            "readOnly": true,
            "type": "integer"
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe *task* is the basic object around which many operations in Asana are centered.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe *task* is the basic object around which many operations in Asana are centered.\nThe parent of this task, or `null` if this is not a subtask. This property cannot be modified using a PUT request but you can change it with the `setParent` endpoint. You can create subtasks by using the subtasks endpoint.",
            "nullable": true,
            "properties": {
              "created_by": {
                "description": "[Opt In](/docs/inputoutput-options). A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource.",
                    "example": "1111",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of resource.",
                    "example": "user",
                    "type": "string"
                  }
                },
                "readOnly": true,
                "type": "object"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the task.",
                "example": "Bug Task",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe resource_subtype `milestone` represent a single moment in time. This means tasks with this subtype cannot have a start_date.",
                "enum": [
                  "default_task",
                  "milestone",
                  "approval",
                  "custom"
                ],
                "example": "default_task",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "task"
            }
          },
          "permalink_url": {
            "description": "A url that points directly to the object within Asana.",
            "example": "https://app.asana.com/1/12345/task/123456789",
            "readOnly": true,
            "type": "string"
          },
          "projects": {
            "description": "*Create-only.* Array of projects this task is directly associated with. At task creation time, this array can be used to add the task to many projects at once. After task creation, these associations can be modified using the addProject and removeProject endpoints.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "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.",
                  "example": "Stuff to buy",
                  "type": "string"
                },
                "resource_subtype": {
                  "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                  "enum": [
                    "default_project",
                    "custom"
                  ],
                  "example": "default_project",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "project"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe resource_subtype `milestone` represent a single moment in time. This means tasks with this subtype cannot have a start_date.",
            "enum": [
              "default_task",
              "milestone",
              "approval",
              "custom"
            ],
            "example": "default_task",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_at": {
            "description": "Date and time on which work begins for the task, or null if the task has no start time. This takes an ISO 8601 date string in UTC and should not be used together with `start_on`.\n*Note: `due_at` must be present in the request when setting or unsetting the `start_at` parameter.*",
            "example": "2019-09-14T02:06:58.147Z",
            "format": "date-time",
            "nullable": true,
            "type": "string"
          },
          "start_on": {
            "description": "The day on which work begins for the task , or null if the task has no start date. This takes a date with `YYYY-MM-DD` format and should not be used together with `start_at`.\n*Note: `due_on` or `due_at` must be present in the request when setting or unsetting the `start_on` parameter.*",
            "example": "2019-09-14",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "tags": {
            "description": "Array of tags associated with this task. In order to change tags on an existing task use `addTag` and `removeTag`.",
            "example": [
              {
                "gid": "59746",
                "name": "Grade A"
              }
            ],
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *tag* is a label that can be attached to any task in Asana. It exists in a single workspace or organization.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "Name of the tag. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.",
                  "example": "Stuff to buy",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "tag"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "workspace": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.\n*Create-only*. The workspace this task is associated with. Once created, task cannot be moved to a different workspace. This attribute can only be specified at creation time.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the workspace.",
                "example": "My Company Workspace",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "workspace"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "task"
        }
      },
      "sdk__TaskResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__TaskResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__TaskResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__TaskResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__TaskSetParentRequest": {
        "properties": {
          "insert_after": {
            "description": "A subtask of the parent to insert the task after, or `null` to insert at the beginning of the list.",
            "example": "null",
            "nullable": true,
            "type": "string"
          },
          "insert_before": {
            "description": "A subtask of the parent to insert the task before, or `null` to insert at the end of the list.",
            "example": "124816",
            "nullable": true,
            "type": "string"
          },
          "parent": {
            "description": "The new parent of the task, or `null` for no parent.",
            "example": "987654",
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "parent"
        ],
        "type": "object"
      },
      "sdk__TaskStoryCreateRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA story represents an activity associated with an object in the Asana system.",
        "properties": {
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_text": {
            "description": "[Opt In](/docs/inputoutput-options). HTML formatted text for a comment. This will not include the name of the creator. See [rich text](/docs/rich-text).",
            "example": "<body>This is a comment.</body>",
            "type": "string"
          },
          "is_pinned": {
            "description": "*Conditional*. Whether the story should be pinned on the resource.",
            "example": false,
            "type": "boolean"
          },
          "parent_comment": {
            "description": "The GID of the top-level comment envelope to reply to, exposed as `comment_gid` on story reads. This is not the story `gid`. Retrieve it with `GET /stories/{story_gid}?opt_fields=comment_gid`. The parent must belong to the task in the request URL and must not itself be a reply. Works with either `text` or `html_text`. Omit this input to create a top-level comment.",
            "example": "12345",
            "type": "string"
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
            "example": "comment_added",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "sticker_name": {
            "description": "The name of the sticker in this story. `null` if there is no sticker.",
            "enum": [
              "green_checkmark",
              "people_dancing",
              "dancing_unicorn",
              "heart",
              "party_popper",
              "people_waving_flags",
              "splashing_narwhal",
              "trophy",
              "yeti_riding_unicorn",
              "celebrating_people",
              "determined_climbers",
              "phoenix_spreading_love"
            ],
            "example": "dancing_unicorn",
            "type": "string"
          },
          "text": {
            "description": "The plain text of the comment to add. Cannot be used with html_text.",
            "example": "This is a comment.",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "story"
        }
      },
      "sdk__TaskTemplateBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *task template* is an object that allows new tasks to be created with a predefined setup.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "Name of the task template.",
            "example": "Packing list",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "task_template"
        }
      },
      "sdk__TaskTemplateCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *task template* is an object that allows new tasks to be created with a predefined setup.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "Name of the task template.",
            "example": "Packing list",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "task_template"
        }
      },
      "sdk__TaskTemplateInstantiateTaskRequest": {
        "properties": {
          "name": {
            "description": "The name of the new task. If not provided, the name of the task template will be used.",
            "example": "New Task",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__TaskTemplateRecipe": {
        "properties": {
          "attachments": {
            "description": "Array of attachments that will be added to the task created from this template",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nAn *attachment* object represents any file attached to a task in Asana, whether it's an uploaded file or one associated via a third-party service such as Dropbox or Google Drive.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "The name of the file.",
                  "example": "Screenshot.png",
                  "readOnly": true,
                  "type": "string"
                },
                "resource_subtype": {
                  "description": "The service hosting the attachment. Valid values are `asana`, `dropbox`, `gdrive`, `onedrive`, `box`, `vimeo`, and `external`.",
                  "example": "dropbox",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "attachment"
              }
            },
            "type": "array"
          },
          "custom_fields": {
            "description": "Array of custom fields that will be added to the task created from this template",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.",
              "properties": {
                "date_value": {
                  "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                  "nullable": true,
                  "properties": {
                    "date": {
                      "description": "A string representing the date in YYYY-MM-DD format.",
                      "example": "2024-08-23",
                      "type": "string"
                    },
                    "date_time": {
                      "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                      "example": "2024-08-23T22:00:00.000Z",
                      "type": "string"
                    }
                  },
                  "type": "object"
                },
                "display_value": {
                  "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                  "example": "blue",
                  "nullable": true,
                  "readOnly": true,
                  "type": "string"
                },
                "enabled": {
                  "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                  "example": true,
                  "readOnly": true,
                  "type": "boolean"
                },
                "enum_options": {
                  "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                  "items": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                    "properties": {
                      "color": {
                        "description": "The color of the enum option. Defaults to `none`.",
                        "example": "blue",
                        "type": "string"
                      },
                      "enabled": {
                        "description": "Whether or not the enum option is a selectable value for the custom field.",
                        "example": true,
                        "type": "boolean"
                      },
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "The name of the enum option.",
                        "example": "Low",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "enum_option"
                    }
                  },
                  "type": "array"
                },
                "enum_value": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                  "nullable": true,
                  "properties": {
                    "color": {
                      "description": "The color of the enum option. Defaults to `none`.",
                      "example": "blue",
                      "type": "string"
                    },
                    "enabled": {
                      "description": "Whether or not the enum option is a selectable value for the custom field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the enum option.",
                      "example": "Low",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "enum_option"
                  }
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "id_prefix": {
                  "description": "This field is the unique custom ID string for the custom field.",
                  "example": "ID",
                  "nullable": true,
                  "type": "string"
                },
                "input_restrictions": {
                  "example": [
                    "task"
                  ],
                  "items": {
                    "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                    "enum": [
                      "task",
                      "project",
                      "portfolio",
                      "goal"
                    ],
                    "type": "string"
                  },
                  "type": "array"
                },
                "is_formula_field": {
                  "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                  "example": false,
                  "type": "boolean"
                },
                "is_lookup_field": {
                  "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                  "example": false,
                  "type": "boolean"
                },
                "multi_enum_values": {
                  "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                  "items": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                    "properties": {
                      "color": {
                        "description": "The color of the enum option. Defaults to `none`.",
                        "example": "blue",
                        "type": "string"
                      },
                      "enabled": {
                        "description": "Whether or not the enum option is a selectable value for the custom field.",
                        "example": true,
                        "type": "boolean"
                      },
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "The name of the enum option.",
                        "example": "Low",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "enum_option"
                    }
                  },
                  "type": "array"
                },
                "name": {
                  "description": "The name of the custom field.",
                  "example": "Status",
                  "type": "string"
                },
                "number_value": {
                  "description": "*Conditional*. This number is the value of a `number` custom field.",
                  "example": 5.2,
                  "nullable": true,
                  "type": "number"
                },
                "representation_type": {
                  "description": "This field tells the type of the custom field.",
                  "enum": [
                    "text",
                    "enum",
                    "multi_enum",
                    "number",
                    "date",
                    "people",
                    "formula",
                    "custom_id",
                    "reference"
                  ],
                  "example": "number",
                  "readOnly": true,
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                },
                "text_value": {
                  "description": "*Conditional*. This string is the value of a `text` custom field.",
                  "example": "Some Value",
                  "nullable": true,
                  "type": "string"
                },
                "type": {
                  "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                  "enum": [
                    "text",
                    "enum",
                    "multi_enum",
                    "number",
                    "date",
                    "people",
                    "reference"
                  ],
                  "readOnly": true,
                  "type": "string"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "custom_field"
              }
            },
            "type": "array"
          },
          "dependencies": {
            "description": "Array of task templates that the task created from this template will depend on",
            "items": {
              "properties": {
                "name": {
                  "description": "Name of the task that will be created from this template.",
                  "example": "Bug Report",
                  "type": "string"
                },
                "task_resource_subtype": {
                  "description": "The subtype of the task that will be created from this template.",
                  "enum": [
                    "default_task",
                    "milestone_task",
                    "approval_task"
                  ],
                  "example": "default_task",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "dependents": {
            "description": "Array of task templates that will depend on the task created from this template",
            "items": {
              "properties": {
                "name": {
                  "description": "Name of the task that will be created from this template.",
                  "example": "Bug Report",
                  "type": "string"
                },
                "task_resource_subtype": {
                  "description": "The subtype of the task that will be created from this template.",
                  "enum": [
                    "default_task",
                    "milestone_task",
                    "approval_task"
                  ],
                  "example": "default_task",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "description": {
            "description": "Description of the task that will be created from this template.",
            "example": "Please describe the bug you found and how to reproduce it.",
            "type": "string"
          },
          "due_time": {
            "description": "The time of day that the task will be due",
            "example": "13:15:00.000Z",
            "nullable": true,
            "type": "string"
          },
          "followers": {
            "description": "Array of users that will be added as followers to the task created from this template",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "*Read-only except when same user as requester*. The user's name.",
                  "example": "Greg Sanchez",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "user"
              }
            },
            "type": "array"
          },
          "html_description": {
            "description": "HTML description of the task that will be created from this template. See [rich text](/docs/rich-text#reading-rich-text).",
            "example": "Please describe the bug you found and how to reproduce it.",
            "type": "string"
          },
          "memberships": {
            "description": "Array of projects that the task created from this template will be added to",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "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.",
                  "example": "Stuff to buy",
                  "type": "string"
                },
                "resource_subtype": {
                  "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                  "enum": [
                    "default_project",
                    "custom"
                  ],
                  "example": "default_project",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "project"
              }
            },
            "type": "array"
          },
          "name": {
            "description": "Name of the task that will be created from this template.",
            "example": "Bug Report",
            "type": "string"
          },
          "relative_due_on": {
            "description": "The number of days after the task has been instantiated on which that the task will be due",
            "example": 2,
            "nullable": true,
            "type": "integer"
          },
          "relative_start_on": {
            "description": "The number of days after the task has been instantiated on which that the task will start",
            "example": 1,
            "nullable": true,
            "type": "integer"
          },
          "subtasks": {
            "description": "Array of subtasks that will be added to the task created from this template",
            "items": {
              "properties": {
                "name": {
                  "description": "Name of the task that will be created from this template.",
                  "example": "Bug Report",
                  "type": "string"
                },
                "task_resource_subtype": {
                  "description": "The subtype of the task that will be created from this template.",
                  "enum": [
                    "default_task",
                    "milestone_task",
                    "approval_task"
                  ],
                  "example": "default_task",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "task_resource_subtype": {
            "description": "The subtype of the task that will be created from this template.",
            "enum": [
              "default_task",
              "milestone_task",
              "approval_task"
            ],
            "example": "default_task",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__TaskTemplateRecipeCompact": {
        "properties": {
          "name": {
            "description": "Name of the task that will be created from this template.",
            "example": "Bug Report",
            "type": "string"
          },
          "task_resource_subtype": {
            "description": "The subtype of the task that will be created from this template.",
            "enum": [
              "default_task",
              "milestone_task",
              "approval_task"
            ],
            "example": "default_task",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__TaskTemplateResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *task template* is an object that allows new tasks to be created with a predefined setup.",
        "properties": {
          "created_at": {
            "description": "The time at which this task template was created.",
            "example": "2019-01-01T00:00:00.000Z",
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "allOf": [
              {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              }
            ],
            "description": "The user who created this task template."
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "Name of the task template.",
            "example": "Bug Report Template",
            "type": "string"
          },
          "project": {
            "allOf": [
              {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "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.",
                    "example": "Stuff to buy",
                    "type": "string"
                  },
                  "resource_subtype": {
                    "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                    "enum": [
                      "default_project",
                      "custom"
                    ],
                    "example": "default_project",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "project"
                }
              }
            ],
            "description": "The project that this task template belongs to.",
            "nullable": true
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "template": {
            "allOf": [
              {
                "properties": {
                  "attachments": {
                    "description": "Array of attachments that will be added to the task created from this template",
                    "items": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nAn *attachment* object represents any file attached to a task in Asana, whether it's an uploaded file or one associated via a third-party service such as Dropbox or Google Drive.",
                      "properties": {
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "The name of the file.",
                          "example": "Screenshot.png",
                          "readOnly": true,
                          "type": "string"
                        },
                        "resource_subtype": {
                          "description": "The service hosting the attachment. Valid values are `asana`, `dropbox`, `gdrive`, `onedrive`, `box`, `vimeo`, and `external`.",
                          "example": "dropbox",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "attachment"
                      }
                    },
                    "type": "array"
                  },
                  "custom_fields": {
                    "description": "Array of custom fields that will be added to the task created from this template",
                    "items": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.",
                      "properties": {
                        "date_value": {
                          "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                          "nullable": true,
                          "properties": {
                            "date": {
                              "description": "A string representing the date in YYYY-MM-DD format.",
                              "example": "2024-08-23",
                              "type": "string"
                            },
                            "date_time": {
                              "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                              "example": "2024-08-23T22:00:00.000Z",
                              "type": "string"
                            }
                          },
                          "type": "object"
                        },
                        "display_value": {
                          "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                          "example": "blue",
                          "nullable": true,
                          "readOnly": true,
                          "type": "string"
                        },
                        "enabled": {
                          "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                          "example": true,
                          "readOnly": true,
                          "type": "boolean"
                        },
                        "enum_options": {
                          "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                          "items": {
                            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                            "properties": {
                              "color": {
                                "description": "The color of the enum option. Defaults to `none`.",
                                "example": "blue",
                                "type": "string"
                              },
                              "enabled": {
                                "description": "Whether or not the enum option is a selectable value for the custom field.",
                                "example": true,
                                "type": "boolean"
                              },
                              "gid": {
                                "description": "Globally unique identifier of the resource, as a string.",
                                "example": "12345",
                                "readOnly": true,
                                "type": "string",
                                "x-insert-after": false
                              },
                              "name": {
                                "description": "The name of the enum option.",
                                "example": "Low",
                                "type": "string"
                              },
                              "resource_type": {
                                "description": "The base type of this resource.",
                                "example": "task",
                                "readOnly": true,
                                "type": "string",
                                "x-insert-after": "gid"
                              }
                            },
                            "type": "object",
                            "x-docs-overrides": {
                              "properties.resource_type.example": "enum_option"
                            }
                          },
                          "type": "array"
                        },
                        "enum_value": {
                          "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                          "nullable": true,
                          "properties": {
                            "color": {
                              "description": "The color of the enum option. Defaults to `none`.",
                              "example": "blue",
                              "type": "string"
                            },
                            "enabled": {
                              "description": "Whether or not the enum option is a selectable value for the custom field.",
                              "example": true,
                              "type": "boolean"
                            },
                            "gid": {
                              "description": "Globally unique identifier of the resource, as a string.",
                              "example": "12345",
                              "readOnly": true,
                              "type": "string",
                              "x-insert-after": false
                            },
                            "name": {
                              "description": "The name of the enum option.",
                              "example": "Low",
                              "type": "string"
                            },
                            "resource_type": {
                              "description": "The base type of this resource.",
                              "example": "task",
                              "readOnly": true,
                              "type": "string",
                              "x-insert-after": "gid"
                            }
                          },
                          "type": "object",
                          "x-docs-overrides": {
                            "properties.resource_type.example": "enum_option"
                          }
                        },
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "id_prefix": {
                          "description": "This field is the unique custom ID string for the custom field.",
                          "example": "ID",
                          "nullable": true,
                          "type": "string"
                        },
                        "input_restrictions": {
                          "example": [
                            "task"
                          ],
                          "items": {
                            "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                            "enum": [
                              "task",
                              "project",
                              "portfolio",
                              "goal"
                            ],
                            "type": "string"
                          },
                          "type": "array"
                        },
                        "is_formula_field": {
                          "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                          "example": false,
                          "type": "boolean"
                        },
                        "is_lookup_field": {
                          "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                          "example": false,
                          "type": "boolean"
                        },
                        "multi_enum_values": {
                          "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                          "items": {
                            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                            "properties": {
                              "color": {
                                "description": "The color of the enum option. Defaults to `none`.",
                                "example": "blue",
                                "type": "string"
                              },
                              "enabled": {
                                "description": "Whether or not the enum option is a selectable value for the custom field.",
                                "example": true,
                                "type": "boolean"
                              },
                              "gid": {
                                "description": "Globally unique identifier of the resource, as a string.",
                                "example": "12345",
                                "readOnly": true,
                                "type": "string",
                                "x-insert-after": false
                              },
                              "name": {
                                "description": "The name of the enum option.",
                                "example": "Low",
                                "type": "string"
                              },
                              "resource_type": {
                                "description": "The base type of this resource.",
                                "example": "task",
                                "readOnly": true,
                                "type": "string",
                                "x-insert-after": "gid"
                              }
                            },
                            "type": "object",
                            "x-docs-overrides": {
                              "properties.resource_type.example": "enum_option"
                            }
                          },
                          "type": "array"
                        },
                        "name": {
                          "description": "The name of the custom field.",
                          "example": "Status",
                          "type": "string"
                        },
                        "number_value": {
                          "description": "*Conditional*. This number is the value of a `number` custom field.",
                          "example": 5.2,
                          "nullable": true,
                          "type": "number"
                        },
                        "representation_type": {
                          "description": "This field tells the type of the custom field.",
                          "enum": [
                            "text",
                            "enum",
                            "multi_enum",
                            "number",
                            "date",
                            "people",
                            "formula",
                            "custom_id",
                            "reference"
                          ],
                          "example": "number",
                          "readOnly": true,
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        },
                        "text_value": {
                          "description": "*Conditional*. This string is the value of a `text` custom field.",
                          "example": "Some Value",
                          "nullable": true,
                          "type": "string"
                        },
                        "type": {
                          "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                          "enum": [
                            "text",
                            "enum",
                            "multi_enum",
                            "number",
                            "date",
                            "people",
                            "reference"
                          ],
                          "readOnly": true,
                          "type": "string"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "custom_field"
                      }
                    },
                    "type": "array"
                  },
                  "dependencies": {
                    "description": "Array of task templates that the task created from this template will depend on",
                    "items": {
                      "properties": {
                        "name": {
                          "description": "Name of the task that will be created from this template.",
                          "example": "Bug Report",
                          "type": "string"
                        },
                        "task_resource_subtype": {
                          "description": "The subtype of the task that will be created from this template.",
                          "enum": [
                            "default_task",
                            "milestone_task",
                            "approval_task"
                          ],
                          "example": "default_task",
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "dependents": {
                    "description": "Array of task templates that will depend on the task created from this template",
                    "items": {
                      "properties": {
                        "name": {
                          "description": "Name of the task that will be created from this template.",
                          "example": "Bug Report",
                          "type": "string"
                        },
                        "task_resource_subtype": {
                          "description": "The subtype of the task that will be created from this template.",
                          "enum": [
                            "default_task",
                            "milestone_task",
                            "approval_task"
                          ],
                          "example": "default_task",
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "description": {
                    "description": "Description of the task that will be created from this template.",
                    "example": "Please describe the bug you found and how to reproduce it.",
                    "type": "string"
                  },
                  "due_time": {
                    "description": "The time of day that the task will be due",
                    "example": "13:15:00.000Z",
                    "nullable": true,
                    "type": "string"
                  },
                  "followers": {
                    "description": "Array of users that will be added as followers to the task created from this template",
                    "items": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                      "properties": {
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "*Read-only except when same user as requester*. The user's name.",
                          "example": "Greg Sanchez",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "user"
                      }
                    },
                    "type": "array"
                  },
                  "html_description": {
                    "description": "HTML description of the task that will be created from this template. See [rich text](/docs/rich-text#reading-rich-text).",
                    "example": "Please describe the bug you found and how to reproduce it.",
                    "type": "string"
                  },
                  "memberships": {
                    "description": "Array of projects that the task created from this template will be added to",
                    "items": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
                      "properties": {
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "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.",
                          "example": "Stuff to buy",
                          "type": "string"
                        },
                        "resource_subtype": {
                          "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                          "enum": [
                            "default_project",
                            "custom"
                          ],
                          "example": "default_project",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "project"
                      }
                    },
                    "type": "array"
                  },
                  "name": {
                    "description": "Name of the task that will be created from this template.",
                    "example": "Bug Report",
                    "type": "string"
                  },
                  "relative_due_on": {
                    "description": "The number of days after the task has been instantiated on which that the task will be due",
                    "example": 2,
                    "nullable": true,
                    "type": "integer"
                  },
                  "relative_start_on": {
                    "description": "The number of days after the task has been instantiated on which that the task will start",
                    "example": 1,
                    "nullable": true,
                    "type": "integer"
                  },
                  "subtasks": {
                    "description": "Array of subtasks that will be added to the task created from this template",
                    "items": {
                      "properties": {
                        "name": {
                          "description": "Name of the task that will be created from this template.",
                          "example": "Bug Report",
                          "type": "string"
                        },
                        "task_resource_subtype": {
                          "description": "The subtype of the task that will be created from this template.",
                          "enum": [
                            "default_task",
                            "milestone_task",
                            "approval_task"
                          ],
                          "example": "default_task",
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "task_resource_subtype": {
                    "description": "The subtype of the task that will be created from this template.",
                    "enum": [
                      "default_task",
                      "milestone_task",
                      "approval_task"
                    ],
                    "example": "default_task",
                    "type": "string"
                  }
                },
                "type": "object"
              }
            ],
            "description": "The configuration for the task that will be created from this template."
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "task_template"
        }
      },
      "sdk__TaskTemplateResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__TaskTemplateResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__TaskTemplateResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__TaskTemplateResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__TaskUpdateRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe *task* is the basic object around which many operations in Asana are centered.",
        "properties": {
          "actual_time_minutes": {
            "description": "This value represents the sum of all the Time Tracking entries in the Actual Time field on a given Task. It is represented as a nullable long value.",
            "example": 200,
            "nullable": true,
            "readOnly": true,
            "type": "number"
          },
          "approval_status": {
            "description": "*Conditional* Reflects the approval status of this task. This field is kept in sync with `completed`, meaning `pending` translates to false while `approved`, `rejected`, and `changes_requested` translate to true. If you set completed to true, this field will be set to `approved`.",
            "enum": [
              "pending",
              "approved",
              "rejected",
              "changes_requested"
            ],
            "example": "pending",
            "type": "string"
          },
          "assigned_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.\nThe user who assigned the task. This field is only returned when requesting it via opt_fields, and will be null if the task has no specific assigner (e.g., tasks created without an explicit assigner).",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "assignee": {
            "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
            "example": "12345",
            "nullable": true,
            "readOnly": false,
            "type": "string",
            "x-env-variable": true
          },
          "assignee_section": {
            "description": "The *assignee section* is a subdivision of a project that groups tasks together in the assignee's \"My tasks\" list. It can either be a header above a list of tasks in a list view or a column in a board view of \"My tasks.\"\nThe `assignee_section` property will be returned in the response only if the request was sent by the user who is the assignee of the task. Note that you can only write to `assignee_section` with the gid of an existing section visible in the user's \"My tasks\" list.",
            "example": "12345",
            "nullable": true,
            "type": "string"
          },
          "assignee_status": {
            "description": "*Deprecated* Scheduling status of this task for the user it is assigned to. This field can only be set if the assignee is non-null. Setting this field to \"inbox\" or \"upcoming\" inserts it at the top of the section, while the other options will insert at the bottom.",
            "enum": [
              "today",
              "upcoming",
              "later",
              "new",
              "inbox"
            ],
            "example": "upcoming",
            "type": "string"
          },
          "completed": {
            "description": "True if the task is currently marked complete, false if not.",
            "example": false,
            "type": "boolean"
          },
          "completed_at": {
            "description": "The time at which this task was completed, or null if the task is incomplete.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "completed_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "nullable": true,
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "created_by": {
            "description": "[Opt In](/docs/inputoutput-options). A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource.",
                "example": "1111",
                "type": "string"
              },
              "resource_type": {
                "description": "The type of resource.",
                "example": "user",
                "type": "string"
              }
            },
            "readOnly": true,
            "type": "object"
          },
          "custom_fields": {
            "additionalProperties": {
              "description": "\"{custom_field_gid}\" => Value (can be text, a number, etc.). For date, use format \"YYYY-MM-DD\" (e.g., 2019-09-15). For date-time, use ISO 8601 date string in UTC (e.g., 2019-09-15T02:06:58.147Z).",
              "type": "string"
            },
            "description": "An object where each key is the GID of a custom field and its corresponding value is either an enum GID, string, number, object, or array (depending on the custom field type). See the [custom fields guide](/docs/custom-fields-guide) for details on creating and updating custom field values.",
            "example": {
              "4578152156": "Not Started",
              "5678904321": "On Hold"
            },
            "type": "object"
          },
          "custom_type": {
            "description": "*Conditional:* You can only set custom_type if task `resource_subtype` is `custom`. GID or globally-unique identifier of a task's custom type. The type must be valid for tasks, and some Asana-created custom types cannot be assigned via the API; attempting either returns an error explaining which condition failed.",
            "example": "12345",
            "nullable": true,
            "readOnly": false,
            "type": "string",
            "x-env-variable": true
          },
          "custom_type_status_option": {
            "description": "*Conditional:* You can only set custom_type_status_option if task `resource_subtype` is `custom` GID or globally-unique identifier of a custom type's status option.",
            "example": "12345",
            "nullable": true,
            "readOnly": false,
            "type": "string",
            "x-env-variable": true
          },
          "dependencies": {
            "description": "[Opt In](/docs/inputoutput-options). Array of resources referencing tasks that this task depends on. The objects contain only the gid of the dependency.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "dependents": {
            "description": "[Opt In](/docs/inputoutput-options). Array of resources referencing tasks that depend on this task. The objects contain only the ID of the dependent.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "due_at": {
            "description": "The UTC date and time on which this task is due, or null if the task has no due time. This takes an ISO 8601 date string in UTC and should not be used together with `due_on`.",
            "example": "2019-09-15T02:06:58.147Z",
            "format": "date-time",
            "nullable": true,
            "type": "string"
          },
          "due_on": {
            "description": "The localized date on which this task is due, or null if the task has no due date. This takes a date with `YYYY-MM-DD` format and should not be used together with `due_at`.",
            "example": "2019-09-15",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "external": {
            "description": "*OAuth Required*. *Conditional*. This field is returned only if external values are set or included by using [Opt In](/docs/inputoutput-options).\nThe external field allows you to store app-specific metadata on tasks, including a gid that can be used to retrieve tasks and a data blob that can store app-specific character strings. Note that you will need to authenticate with Oauth to access or modify this data. Once an external gid is set, you can use the notation `external:custom_gid` to reference your object anywhere in the API where you may use the original object gid. See the page on Custom External Data for more details.",
            "example": {
              "data": "A blob of information",
              "gid": "my_gid"
            },
            "properties": {
              "data": {
                "example": "A blob of information.",
                "type": "string"
              },
              "gid": {
                "example": "1234",
                "type": "string"
              }
            },
            "type": "object"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "has_subtasks_date_mismatch": {
            "description": "[Opt In](/docs/inputoutput-options). True when one or more descendant subtasks have dates outside the task's own date range. This field reflects the latest computed rollup state and returns false when no rollup has been computed.",
            "example": true,
            "readOnly": true,
            "type": "boolean"
          },
          "hearted": {
            "description": "*Deprecated - please use liked instead* True if the task is hearted by the authorized user, false if not.",
            "example": true,
            "readOnly": true,
            "type": "boolean"
          },
          "hearts": {
            "description": "*Deprecated - please use likes instead* Array of likes for users who have hearted this task.",
            "items": {
              "description": "An object to represent a user's like.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the object, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string"
                },
                "user": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "*Read-only except when same user as requester*. The user's name.",
                      "example": "Greg Sanchez",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "user"
                  }
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "html_custom_fields": {
            "additionalProperties": {
              "description": "\"{custom_field_gid}\" => HTML string (e.g., \"<body>Text content</body>\")",
              "type": "string"
            },
            "description": "An object where each key is the GID of a text custom field and the corresponding value is a rich text HTML string. Only text-type custom fields support this parameter. Values must be wrapped in <body></body> tags. See the [custom fields guide](/docs/custom-fields-guide) and [rich text](/docs/rich-text) for details on supported formatting.",
            "example": {
              "4578152156": "<body><code>Code block</code></body>",
              "5678904321": "<body><strong>Bold text</strong></body>"
            },
            "type": "object"
          },
          "html_notes": {
            "description": "[Opt In](/docs/inputoutput-options). The notes of the text with formatting as HTML. See [rich text](/docs/rich-text).",
            "example": "<body>Mittens <em>really</em> likes the stuff from Humboldt.</body>",
            "type": "string"
          },
          "is_rendered_as_separator": {
            "description": "[Opt In](/docs/inputoutput-options). In some contexts tasks can be rendered as a visual separator; for instance, subtasks can appear similar to [sections](/reference/sections) without being true `section` objects. If a `task` object is rendered this way in any context it will have the property `is_rendered_as_separator` set to `true`. This parameter only applies to regular tasks with `resource_subtype` of `default_task`. Tasks with `resource_subtype` of `milestone`, `approval`, or custom task types will not have this property and cannot be rendered as separators.",
            "example": false,
            "readOnly": true,
            "type": "boolean"
          },
          "liked": {
            "description": "True if the task is liked by the authorized user, false if not.",
            "example": true,
            "type": "boolean"
          },
          "likes": {
            "description": "Array of likes for users who have liked this task.",
            "items": {
              "description": "An object to represent a user's like.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the object, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string"
                },
                "user": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "*Read-only except when same user as requester*. The user's name.",
                      "example": "Greg Sanchez",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "user"
                  }
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "memberships": {
            "description": "*Create-only*. Array of projects this task is associated with and the section it is in. At task creation time, this array can be used to add the task to specific sections. After task creation, these associations can be modified using the `addProject` and `removeProject` endpoints. Note that over time, more types of memberships may be added to this property.",
            "items": {
              "properties": {
                "project": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "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.",
                      "example": "Stuff to buy",
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                      "enum": [
                        "default_project",
                        "custom"
                      ],
                      "example": "default_project",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "project"
                  }
                },
                "section": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *section* is a subdivision of a project that groups tasks together. It can either be a header above a list of tasks in a list view or a column in a board view of a project.",
                  "nullable": true,
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the section (i.e. the text displayed as the section header).",
                      "example": "Next Actions",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "section"
                  }
                }
              },
              "type": "object"
            },
            "readOnly": true,
            "type": "array"
          },
          "modified_at": {
            "description": "The time at which this task was last modified.\n\nThe following conditions will change `modified_at`:\n\n- story is created on a task\n- story is trashed on a task\n- attachment is trashed on a task\n- task is assigned or unassigned\n- custom field value is changed\n- the task itself is trashed\n- Or if any of the following fields are updated:\n  - completed\n  - name\n  - due_date\n  - description\n  - attachments\n  - items\n  - schedule_status\n\nThe following conditions will _not_ change `modified_at`:\n\n- moving to a new container (project, portfolio, etc)\n- comments being added to the task (but the stories they generate\n  _will_ affect `modified_at`)",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "name": {
            "description": "Name of the task. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.",
            "example": "Buy catnip",
            "type": "string"
          },
          "notes": {
            "description": "Free-form textual information associated with the task (i.e. its description).",
            "example": "Mittens really likes the stuff from Humboldt.",
            "type": "string"
          },
          "num_hearts": {
            "description": "*Deprecated - please use likes instead* The number of users who have hearted this task.",
            "example": 5,
            "readOnly": true,
            "type": "integer"
          },
          "num_likes": {
            "description": "The number of users who have liked this task.",
            "example": 5,
            "readOnly": true,
            "type": "integer"
          },
          "num_subtasks": {
            "description": "[Opt In](/docs/inputoutput-options). The number of subtasks on this task.\n",
            "example": 3,
            "readOnly": true,
            "type": "integer"
          },
          "parent": {
            "description": "Gid of a task.",
            "example": "12345",
            "nullable": true,
            "readOnly": false,
            "type": "string",
            "x-env-variable": true
          },
          "resource_subtype": {
            "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe resource_subtype `milestone` represent a single moment in time. This means tasks with this subtype cannot have a start_date.",
            "enum": [
              "default_task",
              "milestone",
              "approval",
              "custom"
            ],
            "example": "default_task",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_at": {
            "description": "Date and time on which work begins for the task, or null if the task has no start time. This takes an ISO 8601 date string in UTC and should not be used together with `start_on`.\n*Note: `due_at` must be present in the request when setting or unsetting the `start_at` parameter.*",
            "example": "2019-09-14T02:06:58.147Z",
            "format": "date-time",
            "nullable": true,
            "type": "string"
          },
          "start_on": {
            "description": "The day on which work begins for the task , or null if the task has no start date. This takes a date with `YYYY-MM-DD` format and should not be used together with `start_at`.\n*Note: `due_on` or `due_at` must be present in the request when setting or unsetting the `start_on` parameter.*",
            "example": "2019-09-14",
            "format": "date",
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "task"
        }
      },
      "sdk__TeamAddUserRequest": {
        "description": "A user identification object for specification with the addUser/removeUser endpoints.",
        "properties": {
          "user": {
            "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
            "example": "12345",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__TeamBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *team* is used to group related projects and people together within an organization. Each project in an organization is associated with a team.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the team.",
            "example": "Marketing",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "team"
        }
      },
      "sdk__TeamCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *team* is used to group related projects and people together within an organization. Each project in an organization is associated with a team.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the team.",
            "example": "Marketing",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "team"
        }
      },
      "sdk__TeamMembershipBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object represents a user's connection to a team.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "is_admin": {
            "description": "Describes if the user is a team admin.",
            "example": false,
            "type": "boolean"
          },
          "is_guest": {
            "description": "Describes if the user is a guest in the team.",
            "example": false,
            "type": "boolean"
          },
          "is_limited_access": {
            "description": "Describes if the user has limited access to the team.",
            "example": false,
            "readOnly": true,
            "type": "boolean"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "team": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *team* is used to group related projects and people together within an organization. Each project in an organization is associated with a team.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the team.",
                "example": "Marketing",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "team"
            }
          },
          "user": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "team_membership"
        }
      },
      "sdk__TeamMembershipCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object represents a user's connection to a team.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "is_admin": {
            "description": "Describes if the user is a team admin.",
            "example": false,
            "type": "boolean"
          },
          "is_guest": {
            "description": "Describes if the user is a guest in the team.",
            "example": false,
            "type": "boolean"
          },
          "is_limited_access": {
            "description": "Describes if the user has limited access to the team.",
            "example": false,
            "readOnly": true,
            "type": "boolean"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "team": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *team* is used to group related projects and people together within an organization. Each project in an organization is associated with a team.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the team.",
                "example": "Marketing",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "team"
            }
          },
          "user": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "team_membership"
        }
      },
      "sdk__TeamMembershipResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object represents a user's connection to a team.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "is_admin": {
            "description": "Describes if the user is a team admin.",
            "example": false,
            "type": "boolean"
          },
          "is_guest": {
            "description": "Describes if the user is a guest in the team.",
            "example": false,
            "type": "boolean"
          },
          "is_limited_access": {
            "description": "Describes if the user has limited access to the team.",
            "example": false,
            "readOnly": true,
            "type": "boolean"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "team": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *team* is used to group related projects and people together within an organization. Each project in an organization is associated with a team.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the team.",
                "example": "Marketing",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "team"
            }
          },
          "user": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "team_membership"
        }
      },
      "sdk__TeamMembershipResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__TeamMembershipResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__TeamMembershipResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__TeamMembershipResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__TeamRemoveUserRequest": {
        "description": "A user identification object for specification with the addUser/removeUser endpoints.",
        "properties": {
          "user": {
            "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
            "example": "12345",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__TeamRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *team* is used to group related projects and people together within an organization. Each project in an organization is associated with a team.",
        "properties": {
          "description": {
            "description": "The description of the team.\n",
            "example": "All developers should be members of this team.",
            "type": "string"
          },
          "edit_team_name_or_description_access_level": {
            "description": "Controls who can edit team name and description\n",
            "enum": [
              "all_team_members",
              "only_team_admins"
            ],
            "type": "string"
          },
          "edit_team_visibility_or_trash_team_access_level": {
            "description": "Controls who can edit team visibility and trash teams\n",
            "enum": [
              "all_team_members",
              "only_team_admins"
            ],
            "type": "string"
          },
          "endorsed": {
            "description": "Whether the team has been endorsed\n",
            "example": false,
            "type": "boolean"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "guest_invite_management_access_level": {
            "description": "Controls who can accept or deny guest invites for a given team\n",
            "enum": [
              "all_team_members",
              "only_team_admins"
            ],
            "type": "string"
          },
          "html_description": {
            "description": "The description of the team with formatting as HTML. See [rich text](/docs/rich-text).\n",
            "example": "<body><em>All</em> developers should be members of this team.</body>",
            "type": "string"
          },
          "join_request_management_access_level": {
            "description": "Controls who can accept or deny join team requests for a Membership by Request team. This field can only be updated when the team's `visibility` field is `request_to_join`.\n",
            "enum": [
              "all_team_members",
              "only_team_admins"
            ],
            "type": "string"
          },
          "member_invite_management_access_level": {
            "description": "Controls who can accept or deny member invites for a given team\n",
            "enum": [
              "all_team_members",
              "only_team_admins"
            ],
            "type": "string"
          },
          "name": {
            "description": "The name of the team.",
            "example": "Marketing",
            "type": "string"
          },
          "organization": {
            "description": "The organization/workspace the team belongs to. This must be the same organization you are in and cannot be changed once set.\n",
            "example": "123456789",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "team_content_management_access_level": {
            "description": "Controls who can create and share content with the team\n",
            "enum": [
              "no_restriction",
              "only_team_admins"
            ],
            "type": "string"
          },
          "team_member_removal_access_level": {
            "description": "Controls who can remove team members\n",
            "enum": [
              "all_team_members",
              "only_team_admins"
            ],
            "type": "string"
          },
          "visibility": {
            "description": "The visibility of the team to users in the same organization\n",
            "enum": [
              "secret",
              "request_to_join",
              "public"
            ],
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "team"
        }
      },
      "sdk__TeamResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *team* is used to group related projects and people together within an organization. Each project in an organization is associated with a team.",
        "properties": {
          "custom_field_settings": {
            "description": "Array of Custom Field Settings applied to the team.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields Settings objects represent the many-to-many join of the Custom Field and Project as well as stores information that is relevant to that particular pairing.",
              "properties": {
                "custom_field": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.\nThe custom field that is applied to the `parent`.",
                  "properties": {
                    "asana_created_field": {
                      "description": "*Conditional*. A unique identifier to associate this field with the template source of truth.",
                      "enum": [
                        "a_v_requirements",
                        "account_name",
                        "actionable",
                        "align_shipping_link",
                        "align_status",
                        "allotted_time",
                        "appointment",
                        "approval_stage",
                        "approved",
                        "article_series",
                        "board_committee",
                        "browser",
                        "campaign_audience",
                        "campaign_project_status",
                        "campaign_regions",
                        "channel_primary",
                        "client_topic_type",
                        "complete_by",
                        "contact",
                        "contact_email_address",
                        "content_channels",
                        "content_channels_needed",
                        "content_stage",
                        "content_type",
                        "contract",
                        "contract_status",
                        "cost",
                        "creation_stage",
                        "creative_channel",
                        "creative_needed",
                        "creative_needs",
                        "data_sensitivity",
                        "deal_size",
                        "delivery_appt",
                        "delivery_appt_date",
                        "department",
                        "department_responsible",
                        "design_request_needed",
                        "design_request_type",
                        "discussion_category",
                        "do_this_task",
                        "editorial_content_status",
                        "editorial_content_tag",
                        "editorial_content_type",
                        "effort",
                        "effort_level",
                        "est_completion_date",
                        "estimated_time",
                        "estimated_value",
                        "expected_cost",
                        "external_steps_needed",
                        "favorite_idea",
                        "feedback_type",
                        "financial",
                        "funding_amount",
                        "grant_application_process",
                        "hiring_candidate_status",
                        "idea_status",
                        "ids_link",
                        "ids_patient_link",
                        "implementation_stage",
                        "insurance",
                        "interview_area",
                        "interview_question_score",
                        "itero_scan_link",
                        "job_s_applied_to",
                        "lab",
                        "launch_status",
                        "lead_status",
                        "localization_language",
                        "localization_market_team",
                        "localization_status",
                        "meeting_minutes",
                        "meeting_needed",
                        "minutes",
                        "mrr",
                        "must_localize",
                        "name_of_foundation",
                        "need_to_follow_up",
                        "next_appointment",
                        "next_steps_sales",
                        "num_people",
                        "number_of_user_reports",
                        "office_location",
                        "onboarding_activity",
                        "owner",
                        "participants_needed",
                        "patient_date_of_birth",
                        "patient_email",
                        "patient_phone",
                        "patient_status",
                        "phone_number",
                        "planning_category",
                        "point_of_contact",
                        "position",
                        "post_format",
                        "prescription",
                        "priority",
                        "priority_level",
                        "product",
                        "product_stage",
                        "progress",
                        "project_size",
                        "project_status",
                        "proposed_budget",
                        "publish_status",
                        "reason_for_scan",
                        "referral",
                        "request_type",
                        "research_status",
                        "responsible_department",
                        "responsible_team",
                        "risk_assessment_status",
                        "room_name",
                        "sales_counterpart",
                        "sentiment",
                        "shipping_link",
                        "social_channels",
                        "stage",
                        "status",
                        "status_design",
                        "status_of_initiative",
                        "system_setup",
                        "task_progress",
                        "team",
                        "team_marketing",
                        "team_responsible",
                        "time_it_takes_to_complete_tasks",
                        "timeframe",
                        "treatment_type",
                        "type_work_requests_it",
                        "use_agency",
                        "user_name",
                        "vendor_category",
                        "vendor_type",
                        "word_count",
                        null
                      ],
                      "example": "priority",
                      "nullable": true,
                      "readOnly": true,
                      "type": "string"
                    },
                    "created_by": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                      "nullable": true,
                      "properties": {
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "*Read-only except when same user as requester*. The user's name.",
                          "example": "Greg Sanchez",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "user"
                      }
                    },
                    "currency_code": {
                      "description": "ISO 4217 currency code to format this custom field. This will be null if the `format` is not `currency`.",
                      "example": "EUR",
                      "nullable": true,
                      "type": "string"
                    },
                    "custom_label": {
                      "description": "This is the string that appears next to the custom field value. This will be null if the `format` is not `custom`.",
                      "example": "gold pieces",
                      "nullable": true,
                      "type": "string"
                    },
                    "custom_label_position": {
                      "description": "Only relevant for custom fields with `custom` format. This depicts where to place the custom label. This will be null if the `format` is not `custom`.",
                      "enum": [
                        "prefix",
                        "suffix",
                        null
                      ],
                      "example": "suffix",
                      "nullable": true,
                      "type": "string"
                    },
                    "date_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                      "nullable": true,
                      "properties": {
                        "date": {
                          "description": "A string representing the date in YYYY-MM-DD format.",
                          "example": "2024-08-23",
                          "type": "string"
                        },
                        "date_time": {
                          "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                          "example": "2024-08-23T22:00:00.000Z",
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    "default_access_level": {
                      "description": "The default access level when inviting new members to the custom field. This isn't applied when the `privacy_setting` is `private`, or the user is a guest. For local fields in a project or portfolio, the user must additionally have permission to modify the container itself.",
                      "enum": [
                        "admin",
                        "editor",
                        "user"
                      ],
                      "example": "user",
                      "type": "string"
                    },
                    "description": {
                      "description": "[Opt In](/docs/inputoutput-options). The description of the custom field.",
                      "example": "Development team priority",
                      "type": "string"
                    },
                    "display_value": {
                      "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                      "example": "blue",
                      "nullable": true,
                      "readOnly": true,
                      "type": "string"
                    },
                    "enabled": {
                      "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                      "example": true,
                      "readOnly": true,
                      "type": "boolean"
                    },
                    "enum_options": {
                      "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                        "properties": {
                          "color": {
                            "description": "The color of the enum option. Defaults to `none`.",
                            "example": "blue",
                            "type": "string"
                          },
                          "enabled": {
                            "description": "Whether or not the enum option is a selectable value for the custom field.",
                            "example": true,
                            "type": "boolean"
                          },
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "The name of the enum option.",
                            "example": "Low",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object",
                        "x-docs-overrides": {
                          "properties.resource_type.example": "enum_option"
                        }
                      },
                      "type": "array"
                    },
                    "enum_value": {
                      "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                      "nullable": true,
                      "properties": {
                        "color": {
                          "description": "The color of the enum option. Defaults to `none`.",
                          "example": "blue",
                          "type": "string"
                        },
                        "enabled": {
                          "description": "Whether or not the enum option is a selectable value for the custom field.",
                          "example": true,
                          "type": "boolean"
                        },
                        "gid": {
                          "description": "Globally unique identifier of the resource, as a string.",
                          "example": "12345",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": false
                        },
                        "name": {
                          "description": "The name of the enum option.",
                          "example": "Low",
                          "type": "string"
                        },
                        "resource_type": {
                          "description": "The base type of this resource.",
                          "example": "task",
                          "readOnly": true,
                          "type": "string",
                          "x-insert-after": "gid"
                        }
                      },
                      "type": "object",
                      "x-docs-overrides": {
                        "properties.resource_type.example": "enum_option"
                      }
                    },
                    "format": {
                      "description": "The format of this custom field.",
                      "enum": [
                        "currency",
                        "identifier",
                        "percentage",
                        "custom",
                        "duration",
                        "none"
                      ],
                      "example": "custom",
                      "type": "string"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "has_notifications_enabled": {
                      "description": "*Conditional*. This flag describes whether a follower of a task with this field should receive inbox notifications from changes to this field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "html_text_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `text`. This is the HTML representation of the text value of a custom field, corresponding to the `text_value` plain-text field. See [rich text](/docs/rich-text#reading-rich-text).",
                      "example": "<body>Some Value</body>",
                      "nullable": true,
                      "readOnly": true,
                      "type": "string"
                    },
                    "id_prefix": {
                      "description": "This field is the unique custom ID string for the custom field.",
                      "example": "ID",
                      "nullable": true,
                      "type": "string"
                    },
                    "input_restrictions": {
                      "example": [
                        "task"
                      ],
                      "items": {
                        "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                        "enum": [
                          "task",
                          "project",
                          "portfolio",
                          "goal"
                        ],
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "is_formula_field": {
                      "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                      "example": false,
                      "type": "boolean"
                    },
                    "is_global_to_workspace": {
                      "description": "This flag describes whether this custom field is available to every container in the workspace. Before project-specific custom fields, this field was always true.",
                      "example": true,
                      "readOnly": true,
                      "type": "boolean"
                    },
                    "is_lookup_field": {
                      "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                      "example": false,
                      "type": "boolean"
                    },
                    "is_value_read_only": {
                      "description": "*Conditional*. This flag describes whether a custom field is read only.",
                      "example": false,
                      "type": "boolean"
                    },
                    "multi_enum_values": {
                      "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                        "properties": {
                          "color": {
                            "description": "The color of the enum option. Defaults to `none`.",
                            "example": "blue",
                            "type": "string"
                          },
                          "enabled": {
                            "description": "Whether or not the enum option is a selectable value for the custom field.",
                            "example": true,
                            "type": "boolean"
                          },
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "The name of the enum option.",
                            "example": "Low",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object",
                        "x-docs-overrides": {
                          "properties.resource_type.example": "enum_option"
                        }
                      },
                      "type": "array"
                    },
                    "name": {
                      "description": "The name of the custom field.",
                      "example": "Status",
                      "type": "string"
                    },
                    "number_value": {
                      "description": "*Conditional*. This number is the value of a `number` custom field.",
                      "example": 5.2,
                      "nullable": true,
                      "type": "number"
                    },
                    "people_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `people`. This array of [compact user](/reference/users) objects reflects the values of a `people` custom field.",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                        "properties": {
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "*Read-only except when same user as requester*. The user's name.",
                            "example": "Greg Sanchez",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object",
                        "x-docs-overrides": {
                          "properties.resource_type.example": "user"
                        }
                      },
                      "type": "array"
                    },
                    "precision": {
                      "description": "Only relevant for custom fields of type `Number`. This field dictates the number of places after the decimal to round to, i.e. 0 is integer values, 1 rounds to the nearest tenth, and so on. Must be between 0 and 6, inclusive.\nFor percentage format, this may be unintuitive, as a value of 0.25 has a precision of 0, while a value of 0.251 has a precision of 1. This is due to 0.25 being displayed as 25%.\nThe identifier format will always have a precision of 0.",
                      "example": 2,
                      "type": "integer"
                    },
                    "privacy_setting": {
                      "description": "The privacy setting of the custom field. *Note: Administrators in your organization may restrict the values of `privacy_setting`.*",
                      "enum": [
                        "public_with_guests",
                        "public",
                        "private"
                      ],
                      "example": "public_with_guests",
                      "type": "string"
                    },
                    "reference_value": {
                      "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of objects reflects the values of a `reference` custom field.",
                      "items": {
                        "description": "A generic Asana Resource, containing a globally unique identifier.",
                        "properties": {
                          "gid": {
                            "description": "Globally unique identifier of the resource, as a string.",
                            "example": "12345",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": false
                          },
                          "name": {
                            "description": "The name of the object.",
                            "example": "Bug Task",
                            "type": "string"
                          },
                          "resource_type": {
                            "description": "The base type of this resource.",
                            "example": "task",
                            "readOnly": true,
                            "type": "string",
                            "x-insert-after": "gid"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "representation_type": {
                      "description": "This field tells the type of the custom field.",
                      "enum": [
                        "text",
                        "enum",
                        "multi_enum",
                        "number",
                        "date",
                        "people",
                        "formula",
                        "custom_id",
                        "reference"
                      ],
                      "example": "number",
                      "readOnly": true,
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The type of the custom field. Must be one of the given values.\n",
                      "enum": [
                        "text",
                        "enum",
                        "multi_enum",
                        "number",
                        "date",
                        "people",
                        "reference"
                      ],
                      "example": "text",
                      "readOnly": true,
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    },
                    "text_value": {
                      "description": "*Conditional*. This string is the value of a `text` custom field.",
                      "example": "Some Value",
                      "nullable": true,
                      "type": "string"
                    },
                    "type": {
                      "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                      "enum": [
                        "text",
                        "enum",
                        "multi_enum",
                        "number",
                        "date",
                        "people",
                        "reference"
                      ],
                      "readOnly": true,
                      "type": "string"
                    }
                  },
                  "readOnly": true,
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "custom_field"
                  }
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "is_important": {
                  "description": "`is_important` is used in the Asana web application to determine if this custom field is displayed in the list/grid view of a project or portfolio.",
                  "example": false,
                  "readOnly": true,
                  "type": "boolean"
                },
                "parent": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\nThe parent to which the custom field is applied. This can be a project or portfolio and indicates that the tasks or projects that the parent contains may be given custom field values for this custom field.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "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.",
                      "example": "Stuff to buy",
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                      "enum": [
                        "default_project",
                        "custom"
                      ],
                      "example": "default_project",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "readOnly": true,
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "project"
                  }
                },
                "project": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\n*Deprecated: new integrations should prefer the `parent` field.* The id of the project that this custom field settings refers to.",
                  "properties": {
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "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.",
                      "example": "Stuff to buy",
                      "type": "string"
                    },
                    "resource_subtype": {
                      "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                      "enum": [
                        "default_project",
                        "custom"
                      ],
                      "example": "default_project",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "readOnly": true,
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "project"
                  }
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "custom_field_setting"
              }
            },
            "type": "array"
          },
          "description": {
            "description": "[Opt In](/docs/inputoutput-options). The description of the team.\n",
            "example": "All developers should be members of this team.",
            "type": "string"
          },
          "edit_team_name_or_description_access_level": {
            "description": "Controls who can edit team name and description\n",
            "enum": [
              "all_team_members",
              "only_team_admins"
            ],
            "type": "string"
          },
          "edit_team_visibility_or_trash_team_access_level": {
            "description": "Controls who can edit team visibility and trash teams\n",
            "enum": [
              "all_team_members",
              "only_team_admins"
            ],
            "type": "string"
          },
          "endorsed": {
            "description": "Whether the team has been endorsed\n",
            "example": false,
            "type": "boolean"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "guest_invite_management_access_level": {
            "description": "Controls who can accept or deny guest invites for a given team\n",
            "enum": [
              "all_team_members",
              "only_team_admins"
            ],
            "type": "string"
          },
          "html_description": {
            "description": "[Opt In](/docs/inputoutput-options). The description of the team with formatting as HTML. See [rich text](/docs/rich-text#reading-rich-text).\n",
            "example": "<body><em>All</em> developers should be members of this team.</body>",
            "type": "string"
          },
          "join_request_management_access_level": {
            "description": "Controls who can accept or deny join team requests for a Membership by Request team. This field can only be updated when the team's `visibility` field is `request_to_join`.\n",
            "enum": [
              "all_team_members",
              "only_team_admins"
            ],
            "type": "string"
          },
          "member_invite_management_access_level": {
            "description": "Controls who can accept or deny member invites for a given team\n",
            "enum": [
              "all_team_members",
              "only_team_admins"
            ],
            "type": "string"
          },
          "name": {
            "description": "The name of the team.",
            "example": "Marketing",
            "type": "string"
          },
          "organization": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.\nThe organization/workspace the team belongs to.\n",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the workspace.",
                "example": "My Company Workspace",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "workspace"
            }
          },
          "permalink_url": {
            "description": "A url that points directly to the object within Asana.",
            "example": "https://app.asana.com/0/resource/123456789/list",
            "readOnly": true,
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "team_content_management_access_level": {
            "description": "Controls who can create and share content with the team\n",
            "enum": [
              "no_restriction",
              "only_team_admins"
            ],
            "type": "string"
          },
          "team_member_removal_access_level": {
            "description": "Controls who can remove team members\n",
            "enum": [
              "all_team_members",
              "only_team_admins"
            ],
            "type": "string"
          },
          "visibility": {
            "description": "The visibility of the team to users in the same organization\n",
            "enum": [
              "secret",
              "request_to_join",
              "public"
            ],
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "team"
        }
      },
      "sdk__TeamResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__TeamResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__TeamResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__TeamResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__TemplateRole": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "Name of the template role.",
            "example": "Designer",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object"
      },
      "sdk__TimePeriodBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "display_name": {
            "description": "A string representing the cadence code and the fiscal year.",
            "example": "Q1 FY22",
            "type": "string"
          },
          "end_on": {
            "description": "The localized end date of the time period in `YYYY-MM-DD` format.",
            "example": "2019-09-14",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.",
            "nullable": true,
            "properties": {
              "display_name": {
                "description": "A string representing the cadence code and the fiscal year.",
                "example": "Q1 FY22",
                "type": "string"
              },
              "end_on": {
                "description": "The localized end date of the time period in `YYYY-MM-DD` format.",
                "example": "2019-09-14",
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "period": {
                "description": "The cadence and index of the time period.",
                "enum": [
                  "FY",
                  "H1",
                  "H2",
                  "Q1",
                  "Q2",
                  "Q3",
                  "Q4"
                ],
                "example": "Q1",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              },
              "start_on": {
                "description": "The localized start date of the time period in `YYYY-MM-DD` format.",
                "example": "2019-09-13",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "time_period"
            }
          },
          "period": {
            "description": "The cadence and index of the time period.",
            "enum": [
              "FY",
              "H1",
              "H2",
              "Q1",
              "Q2",
              "Q3",
              "Q4"
            ],
            "example": "Q1",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_on": {
            "description": "The localized start date of the time period in `YYYY-MM-DD` format.",
            "example": "2019-09-13",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "time_period"
        }
      },
      "sdk__TimePeriodCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "display_name": {
            "description": "A string representing the cadence code and the fiscal year.",
            "example": "Q1 FY22",
            "type": "string"
          },
          "end_on": {
            "description": "The localized end date of the time period in `YYYY-MM-DD` format.",
            "example": "2019-09-14",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "period": {
            "description": "The cadence and index of the time period.",
            "enum": [
              "FY",
              "H1",
              "H2",
              "Q1",
              "Q2",
              "Q3",
              "Q4"
            ],
            "example": "Q1",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_on": {
            "description": "The localized start date of the time period in `YYYY-MM-DD` format.",
            "example": "2019-09-13",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "time_period"
        }
      },
      "sdk__TimePeriodResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "display_name": {
            "description": "A string representing the cadence code and the fiscal year.",
            "example": "Q1 FY22",
            "type": "string"
          },
          "end_on": {
            "description": "The localized end date of the time period in `YYYY-MM-DD` format.",
            "example": "2019-09-14",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "parent": {
            "description": "A generic Asana Resource, containing a globally unique identifier.",
            "nullable": true,
            "properties": {
              "display_name": {
                "description": "A string representing the cadence code and the fiscal year.",
                "example": "Q1 FY22",
                "type": "string"
              },
              "end_on": {
                "description": "The localized end date of the time period in `YYYY-MM-DD` format.",
                "example": "2019-09-14",
                "type": "string"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "period": {
                "description": "The cadence and index of the time period.",
                "enum": [
                  "FY",
                  "H1",
                  "H2",
                  "Q1",
                  "Q2",
                  "Q3",
                  "Q4"
                ],
                "example": "Q1",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              },
              "start_on": {
                "description": "The localized start date of the time period in `YYYY-MM-DD` format.",
                "example": "2019-09-13",
                "type": "string"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "time_period"
            }
          },
          "period": {
            "description": "The cadence and index of the time period.",
            "enum": [
              "FY",
              "H1",
              "H2",
              "Q1",
              "Q2",
              "Q3",
              "Q4"
            ],
            "example": "Q1",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_on": {
            "description": "The localized start date of the time period in `YYYY-MM-DD` format.",
            "example": "2019-09-13",
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "time_period"
        }
      },
      "sdk__TimePeriodResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__TimePeriodResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__TimePeriodResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__TimePeriodResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__TimeTrackingCategoryBaseRequest": {
        "properties": {
          "color": {
            "description": "The color associated with this category for display purposes.",
            "enum": [
              "none",
              "red",
              "orange",
              "yellow-orange",
              "yellow",
              "yellow-green",
              "green",
              "blue-green",
              "aqua",
              "blue",
              "indigo",
              "purple",
              "magenta",
              "hot-pink",
              "pink",
              "cool-gray"
            ],
            "example": "blue",
            "type": "string"
          },
          "name": {
            "description": "The name of the time tracking category (e.g., 'Development', 'Meetings').",
            "example": "Development",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__TimeTrackingCategoryCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *time tracking category* is a label that can be assigned to time tracking entries. Categories are workspace-scoped and allow users to classify logged time (e.g., 'Development', 'Meetings').",
        "properties": {
          "color": {
            "description": "The color associated with this category for display purposes.",
            "enum": [
              "none",
              "red",
              "orange",
              "yellow-orange",
              "yellow",
              "yellow-green",
              "green",
              "blue-green",
              "aqua",
              "blue",
              "indigo",
              "purple",
              "magenta",
              "hot-pink",
              "pink",
              "cool-gray"
            ],
            "example": "blue",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the time tracking category.",
            "example": "Development",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "time_tracking_category"
        }
      },
      "sdk__TimeTrackingCategoryCreateRequest": {
        "properties": {
          "color": {
            "description": "The color associated with this category for display purposes.",
            "enum": [
              "none",
              "red",
              "orange",
              "yellow-orange",
              "yellow",
              "yellow-green",
              "green",
              "blue-green",
              "aqua",
              "blue",
              "indigo",
              "purple",
              "magenta",
              "hot-pink",
              "pink",
              "cool-gray"
            ],
            "example": "blue",
            "type": "string"
          },
          "name": {
            "description": "The name of the time tracking category (e.g., 'Development', 'Meetings').",
            "example": "Development",
            "type": "string"
          },
          "workspace": {
            "description": "Globally unique identifier for the workspace.",
            "example": "12345",
            "type": "string"
          }
        },
        "required": [
          "workspace",
          "name"
        ],
        "type": "object"
      },
      "sdk__TimeTrackingCategoryResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *time tracking category* is a label that can be assigned to time tracking entries. Categories are workspace-scoped and allow users to classify logged time (e.g., 'Development', 'Meetings').",
        "properties": {
          "color": {
            "description": "The color associated with this category for display purposes.",
            "enum": [
              "none",
              "red",
              "orange",
              "yellow-orange",
              "yellow",
              "yellow-green",
              "green",
              "blue-green",
              "aqua",
              "blue",
              "indigo",
              "purple",
              "magenta",
              "hot-pink",
              "pink",
              "cool-gray"
            ],
            "example": "blue",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "is_archived": {
            "description": "Whether the category is archived. Archived categories cannot be assigned to new time entries but remain visible on existing entries.",
            "example": false,
            "type": "boolean"
          },
          "name": {
            "description": "The name of the time tracking category.",
            "example": "Development",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "time_tracking_category"
        }
      },
      "sdk__TimeTrackingCategoryResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__TimeTrackingCategoryResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__TimeTrackingCategoryResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__TimeTrackingCategoryResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__TimeTrackingCategoryUpdateRequest": {
        "properties": {
          "color": {
            "description": "The color associated with this category for display purposes.",
            "enum": [
              "none",
              "red",
              "orange",
              "yellow-orange",
              "yellow",
              "yellow-green",
              "green",
              "blue-green",
              "aqua",
              "blue",
              "indigo",
              "purple",
              "magenta",
              "hot-pink",
              "pink",
              "cool-gray"
            ],
            "example": "blue",
            "type": "string"
          },
          "is_archived": {
            "description": "*Optional*. Whether the category is archived. Archived categories cannot be assigned to new time entries but remain visible on existing entries.",
            "example": false,
            "type": "boolean"
          },
          "name": {
            "description": "The name of the time tracking category (e.g., 'Development', 'Meetings').",
            "example": "Development",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__TimeTrackingEntryBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "approval_status": {
            "description": "*Optional*. The current approval status of the entry.",
            "enum": [
              "DRAFT",
              "SUBMITTED",
              "APPROVED",
              "REJECTED"
            ],
            "example": "DRAFT",
            "readOnly": true,
            "type": "string"
          },
          "assignee": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.\nThe user this entry's logged time is attributed to.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "attributable_to": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\nThe attributable to project specifies which project's budget a time entry should be counted toward, if the task belongs to more than one project. If it only belongs to one project, it should be that project.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          "billable_status": {
            "description": "*Optional*. The current billable status of the entry.",
            "enum": [
              "billable",
              "nonBillable",
              "notApplicable"
            ],
            "example": "billable",
            "readOnly": true,
            "type": "string"
          },
          "categories": {
            "description": "The categories linked to this time tracking entry.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *time tracking category* is a label that can be assigned to time tracking entries. Categories are workspace-scoped and allow users to classify logged time (e.g., 'Development', 'Meetings').",
              "properties": {
                "color": {
                  "description": "The color associated with this category for display purposes.",
                  "enum": [
                    "none",
                    "red",
                    "orange",
                    "yellow-orange",
                    "yellow",
                    "yellow-green",
                    "green",
                    "blue-green",
                    "aqua",
                    "blue",
                    "indigo",
                    "purple",
                    "magenta",
                    "hot-pink",
                    "pink",
                    "cool-gray"
                  ],
                  "example": "blue",
                  "type": "string"
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "The name of the time tracking category.",
                  "example": "Development",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "time_tracking_category"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "created_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.\nUser that created a time tracking entry.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "description": {
            "description": "*Optional*. The description of the entry.",
            "example": "My description of work done on this entry",
            "readOnly": true,
            "type": "string"
          },
          "duration_minutes": {
            "description": "Time in minutes tracked by the entry.",
            "example": 12,
            "type": "integer"
          },
          "entered_on": {
            "description": "The day that this entry is logged on.",
            "example": "2015-03-14",
            "format": "date",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "task": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThe *task* is the basic object around which many operations in Asana are centered.",
            "properties": {
              "created_by": {
                "description": "[Opt In](/docs/inputoutput-options). A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource.",
                    "example": "1111",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The type of resource.",
                    "example": "user",
                    "type": "string"
                  }
                },
                "readOnly": true,
                "type": "object"
              },
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the task.",
                "example": "Bug Task",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe resource_subtype `milestone` represent a single moment in time. This means tasks with this subtype cannot have a start_date.",
                "enum": [
                  "default_task",
                  "milestone",
                  "approval",
                  "custom"
                ],
                "example": "default_task",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "task"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "time_tracking_entry"
        }
      },
      "sdk__TimeTrackingEntryBaseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__TimeTrackingEntryBase"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__TimeTrackingEntryCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.",
        "properties": {
          "assignee": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.\nThe user this entry's logged time is attributed to.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "attributable_to": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\nThe attributable to project specifies which project's budget a time entry should be counted toward, if the task belongs to more than one project. If it only belongs to one project, it should be that project.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "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.",
                "example": "Stuff to buy",
                "type": "string"
              },
              "resource_subtype": {
                "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.",
                "enum": [
                  "default_project",
                  "custom"
                ],
                "example": "default_project",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "project"
            }
          },
          "categories": {
            "description": "The categories linked to this time tracking entry.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *time tracking category* is a label that can be assigned to time tracking entries. Categories are workspace-scoped and allow users to classify logged time (e.g., 'Development', 'Meetings').",
              "properties": {
                "color": {
                  "description": "The color associated with this category for display purposes.",
                  "enum": [
                    "none",
                    "red",
                    "orange",
                    "yellow-orange",
                    "yellow",
                    "yellow-green",
                    "green",
                    "blue-green",
                    "aqua",
                    "blue",
                    "indigo",
                    "purple",
                    "magenta",
                    "hot-pink",
                    "pink",
                    "cool-gray"
                  ],
                  "example": "blue",
                  "type": "string"
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "The name of the time tracking category.",
                  "example": "Development",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "time_tracking_category"
              }
            },
            "readOnly": true,
            "type": "array"
          },
          "created_by": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.\nUser that created a time tracking entry.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "duration_minutes": {
            "description": "Time in minutes tracked by the entry.",
            "example": 12,
            "type": "integer"
          },
          "entered_on": {
            "description": "The day that this entry is logged on.",
            "example": "2015-03-14",
            "format": "date",
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "time_tracking_entry"
        }
      },
      "sdk__TimeTrackingEntryCompactArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__TimeTrackingEntryCompact"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__TimesheetApprovalStatusCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *timesheet approval status* object represents the approval status for a user's timesheet for a given week. It tracks whether the timesheet is in draft, submitted, approved, or rejected status.",
        "properties": {
          "approval_status": {
            "description": "The current approval status of the timesheet.",
            "enum": [
              "DRAFT",
              "SUBMITTED",
              "APPROVED",
              "REJECTED"
            ],
            "example": "DRAFT",
            "readOnly": true,
            "type": "string"
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "end_date": {
            "description": "The end date of the timesheet week.",
            "example": "2025-01-12",
            "format": "date",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_date": {
            "description": "The start date of the timesheet week.",
            "example": "2025-01-06",
            "format": "date",
            "readOnly": true,
            "type": "string"
          },
          "user": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "workspace": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the workspace.",
                "example": "My Company Workspace",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "workspace"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "timesheet_approval_status"
        }
      },
      "sdk__TimesheetApprovalStatusResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *timesheet approval status* object represents the approval status for a user's timesheet for a given week. It tracks whether the timesheet is in draft, submitted, approved, or rejected status.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *timesheet approval status* object represents the approval status for a user's timesheet for a given week. It tracks whether the timesheet is in draft, submitted, approved, or rejected status.\nA full *timesheet approval status* object with all available fields.",
        "properties": {
          "approval_status": {
            "description": "The current approval status of the timesheet.",
            "enum": [
              "DRAFT",
              "SUBMITTED",
              "APPROVED",
              "REJECTED"
            ],
            "example": "DRAFT",
            "readOnly": true,
            "type": "string"
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "end_date": {
            "description": "The end date of the timesheet week.",
            "example": "2025-01-12",
            "format": "date",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "start_date": {
            "description": "The start date of the timesheet week.",
            "example": "2025-01-06",
            "format": "date",
            "readOnly": true,
            "type": "string"
          },
          "user": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "workspace": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the workspace.",
                "example": "My Company Workspace",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "workspace"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "timesheet_approval_status"
        }
      },
      "sdk__TimesheetApprovalStatusResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__TimesheetApprovalStatusResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__TimesheetApprovalStatusResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__TimesheetApprovalStatusResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__UpdateTimeTrackingEntryRequest": {
        "properties": {
          "assignee": {
            "description": "*Optional*. The gid of the user which the time is attributed to.",
            "example": "12345",
            "type": "string"
          },
          "attributable_to": {
            "description": "*Optional*. The gid of the project which the time is attributable to.",
            "example": "987654",
            "type": "string"
          },
          "billable_status": {
            "description": "*Optional*. The current billable status of the entry. This field requires the Timesheets and Budgets add-on; including it without the add-on returns a `402 Payment Required` error.",
            "enum": [
              "billable",
              "nonBillable",
              "notApplicable"
            ],
            "example": "billable",
            "type": "string"
          },
          "categories": {
            "description": "*Optional*. The gids of time tracking categories to assign to this time tracking entry. Existing categories will be overridden. Currently limited to a maximum of 1 category. This field requires the Timesheets and Budgets add-on; including it without the add-on returns a `402 Payment Required` error.",
            "example": [
              "12345"
            ],
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "description": {
            "description": "*Optional*. The description of the entry. This field requires the Timesheets and Budgets add-on; including it without the add-on returns a `402 Payment Required` error.",
            "example": "My description of work done on this entry",
            "type": "string"
          },
          "duration_minutes": {
            "description": "*Optional*. Time in minutes tracked by the entry",
            "example": 12,
            "type": "integer"
          },
          "entered_on": {
            "description": "*Optional*. The day that this entry is logged on. Defaults to today if no day specified",
            "example": "2023-03-19",
            "format": "date",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__UpdateTimesheetApprovalStatusRequest": {
        "description": "A request to update a timesheet approval status.",
        "properties": {
          "approval_status": {
            "description": "The desired approval status to transition to. Valid transitions depend on the current status of the timesheet approval status.",
            "enum": [
              "submitted",
              "draft",
              "approved",
              "rejected"
            ],
            "example": "submitted",
            "type": "string"
          },
          "message": {
            "description": "Optional message to include with the transition (e.g., reason for approval or rejection).",
            "example": "Approved by manager",
            "type": "string"
          }
        },
        "required": [
          "approval_status"
        ],
        "type": "object"
      },
      "sdk__UserBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "*Read-only except when same user as requester*. The user's name.",
            "example": "Greg Sanchez",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "user"
        }
      },
      "sdk__UserBaseResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
        "properties": {
          "email": {
            "description": "The user's email address.",
            "example": "gsanchez@example.com",
            "format": "email",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "*Read-only except when same user as requester*. The user's name.",
            "example": "Greg Sanchez",
            "type": "string"
          },
          "photo": {
            "description": "A map of the user's profile photo in various sizes, or null if no photo is set. Sizes provided are 21, 27, 36, 60, 128, and 1024. All images are in PNG format, except for 1024 (which is in JPEG format).",
            "example": {
              "image_1024x1024": "https://...",
              "image_128x128": "https://...",
              "image_21x21": "https://...",
              "image_27x27": "https://...",
              "image_36x36": "https://...",
              "image_60x60": "https://..."
            },
            "nullable": true,
            "properties": {
              "image_1024x1024": {
                "description": "JPEG image of the user at 1024x1024 pixels.",
                "format": "uri",
                "type": "string"
              },
              "image_128x128": {
                "description": "PNG image of the user at 128x128 pixels.",
                "format": "uri",
                "type": "string"
              },
              "image_21x21": {
                "description": "PNG image of the user at 21x21 pixels.",
                "format": "uri",
                "type": "string"
              },
              "image_27x27": {
                "description": "PNG image of the user at 27x27 pixels.",
                "format": "uri",
                "type": "string"
              },
              "image_36x36": {
                "description": "PNG image of the user at 36x36 pixels.",
                "format": "uri",
                "type": "string"
              },
              "image_60x60": {
                "description": "PNG image of the user at 60x60 pixels.",
                "format": "uri",
                "type": "string"
              }
            },
            "readOnly": true,
            "type": "object"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "user"
        }
      },
      "sdk__UserBaseResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__UserBaseResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__UserCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "*Read-only except when same user as requester*. The user's name.",
            "example": "Greg Sanchez",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "user"
        }
      },
      "sdk__UserRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "*Read-only except when same user as requester*. The user's name.",
            "example": "Greg Sanchez",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "user"
        }
      },
      "sdk__UserResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
        "properties": {
          "custom_fields": {
            "description": "Array of Custom Fields.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nCustom Fields store the metadata that is used in order to add user-specified information to tasks in Asana. Be sure to reference the [custom fields](/reference/custom-fields) developer documentation for more information about how custom fields relate to various resources in Asana.\n\nUsers in Asana can [lock custom fields](https://asana.com/guide/help/premium/custom-fields#gl-lock-fields), which will make them read-only when accessed by other users. Attempting to edit a locked custom field will return HTTP error code `403 Forbidden`.",
              "properties": {
                "date_value": {
                  "description": "*Conditional*. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.",
                  "nullable": true,
                  "properties": {
                    "date": {
                      "description": "A string representing the date in YYYY-MM-DD format.",
                      "example": "2024-08-23",
                      "type": "string"
                    },
                    "date_time": {
                      "description": "A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.",
                      "example": "2024-08-23T22:00:00.000Z",
                      "type": "string"
                    }
                  },
                  "type": "object"
                },
                "display_value": {
                  "description": "A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.",
                  "example": "blue",
                  "nullable": true,
                  "readOnly": true,
                  "type": "string"
                },
                "enabled": {
                  "description": "*Conditional*. This field applies only to [custom field values](/docs/custom-fields-guide#/accessing-custom-field-values-on-tasks-or-projects) and is not available for [custom field definitions](/docs/custom-fields-guide#/accessing-custom-field-definitions).\nDetermines if the custom field is enabled or not. For more details, see the [Custom Fields documentation](/docs/custom-fields-guide#/enabled-and-disabled-values).",
                  "example": true,
                  "readOnly": true,
                  "type": "boolean"
                },
                "enum_options": {
                  "description": "*Conditional*. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to [working with enum options](/reference/createenumoptionforcustomfield).",
                  "items": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                    "properties": {
                      "color": {
                        "description": "The color of the enum option. Defaults to `none`.",
                        "example": "blue",
                        "type": "string"
                      },
                      "enabled": {
                        "description": "Whether or not the enum option is a selectable value for the custom field.",
                        "example": true,
                        "type": "boolean"
                      },
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "The name of the enum option.",
                        "example": "Low",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "enum_option"
                    }
                  },
                  "type": "array"
                },
                "enum_value": {
                  "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.\n*Conditional*. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.",
                  "nullable": true,
                  "properties": {
                    "color": {
                      "description": "The color of the enum option. Defaults to `none`.",
                      "example": "blue",
                      "type": "string"
                    },
                    "enabled": {
                      "description": "Whether or not the enum option is a selectable value for the custom field.",
                      "example": true,
                      "type": "boolean"
                    },
                    "gid": {
                      "description": "Globally unique identifier of the resource, as a string.",
                      "example": "12345",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": false
                    },
                    "name": {
                      "description": "The name of the enum option.",
                      "example": "Low",
                      "type": "string"
                    },
                    "resource_type": {
                      "description": "The base type of this resource.",
                      "example": "task",
                      "readOnly": true,
                      "type": "string",
                      "x-insert-after": "gid"
                    }
                  },
                  "type": "object",
                  "x-docs-overrides": {
                    "properties.resource_type.example": "enum_option"
                  }
                },
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "id_prefix": {
                  "description": "This field is the unique custom ID string for the custom field.",
                  "example": "ID",
                  "nullable": true,
                  "type": "string"
                },
                "input_restrictions": {
                  "example": [
                    "task"
                  ],
                  "items": {
                    "description": "*Conditional*. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.",
                    "enum": [
                      "task",
                      "project",
                      "portfolio",
                      "goal"
                    ],
                    "type": "string"
                  },
                  "type": "array"
                },
                "is_formula_field": {
                  "description": "*Conditional*. This flag describes whether a custom field is a formula custom field.",
                  "example": false,
                  "type": "boolean"
                },
                "is_lookup_field": {
                  "description": "*Conditional*. This flag describes whether a custom field is a lookup custom field.",
                  "example": false,
                  "type": "boolean"
                },
                "multi_enum_values": {
                  "description": "*Conditional*. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.",
                  "items": {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nEnum options are the possible values which an enum custom field can adopt. An enum custom field must contain at least 1 enum option but no more than 500.\n\nYou can add enum options to a custom field by using the `POST /custom_fields/custom_field_gid/enum_options` endpoint.\n\n**It is not possible to remove or delete an enum option**. Instead, enum options can be disabled by updating the `enabled` field to false with the `PUT /enum_options/enum_option_gid` endpoint. Other attributes can be updated similarly.\n\nOn creation of an enum option, `enabled` is always set to `true`, meaning the enum option is a selectable value for the custom field. Setting `enabled=false` is equivalent to “trashing” the enum option in the Asana web app within the “Edit Fields” dialog. The enum option will no longer be selectable but, if the enum option value was previously set within a task, the task will retain the value.\n\nEnum options are an ordered list and by default new enum options are inserted at the end. Ordering in relation to existing enum options can be specified on creation by using `insert_before` or `insert_after` to reference an existing enum option. Only one of `insert_before` and `insert_after` can be provided when creating a new enum option.\n\nAn enum options list can be reordered with the `POST /custom_fields/custom_field_gid/enum_options/insert` endpoint.",
                    "properties": {
                      "color": {
                        "description": "The color of the enum option. Defaults to `none`.",
                        "example": "blue",
                        "type": "string"
                      },
                      "enabled": {
                        "description": "Whether or not the enum option is a selectable value for the custom field.",
                        "example": true,
                        "type": "boolean"
                      },
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "The name of the enum option.",
                        "example": "Low",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "enum_option"
                    }
                  },
                  "type": "array"
                },
                "name": {
                  "description": "The name of the custom field.",
                  "example": "Status",
                  "type": "string"
                },
                "number_value": {
                  "description": "*Conditional*. This number is the value of a `number` custom field.",
                  "example": 5.2,
                  "nullable": true,
                  "type": "number"
                },
                "representation_type": {
                  "description": "This field tells the type of the custom field.",
                  "enum": [
                    "text",
                    "enum",
                    "multi_enum",
                    "number",
                    "date",
                    "people",
                    "formula",
                    "custom_id",
                    "reference"
                  ],
                  "example": "number",
                  "readOnly": true,
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                },
                "text_value": {
                  "description": "*Conditional*. This string is the value of a `text` custom field.",
                  "example": "Some Value",
                  "nullable": true,
                  "type": "string"
                },
                "type": {
                  "description": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n",
                  "enum": [
                    "text",
                    "enum",
                    "multi_enum",
                    "number",
                    "date",
                    "people",
                    "reference"
                  ],
                  "readOnly": true,
                  "type": "string"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "custom_field"
              }
            },
            "type": "array"
          },
          "email": {
            "description": "The user's email address.",
            "example": "gsanchez@example.com",
            "format": "email",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "*Read-only except when same user as requester*. The user's name.",
            "example": "Greg Sanchez",
            "type": "string"
          },
          "photo": {
            "description": "A map of the user's profile photo in various sizes, or null if no photo is set. Sizes provided are 21, 27, 36, 60, 128, and 1024. All images are in PNG format, except for 1024 (which is in JPEG format).",
            "example": {
              "image_1024x1024": "https://...",
              "image_128x128": "https://...",
              "image_21x21": "https://...",
              "image_27x27": "https://...",
              "image_36x36": "https://...",
              "image_60x60": "https://..."
            },
            "nullable": true,
            "properties": {
              "image_1024x1024": {
                "description": "JPEG image of the user at 1024x1024 pixels.",
                "format": "uri",
                "type": "string"
              },
              "image_128x128": {
                "description": "PNG image of the user at 128x128 pixels.",
                "format": "uri",
                "type": "string"
              },
              "image_21x21": {
                "description": "PNG image of the user at 21x21 pixels.",
                "format": "uri",
                "type": "string"
              },
              "image_27x27": {
                "description": "PNG image of the user at 27x27 pixels.",
                "format": "uri",
                "type": "string"
              },
              "image_36x36": {
                "description": "PNG image of the user at 36x36 pixels.",
                "format": "uri",
                "type": "string"
              },
              "image_60x60": {
                "description": "PNG image of the user at 60x60 pixels.",
                "format": "uri",
                "type": "string"
              }
            },
            "readOnly": true,
            "type": "object"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "workspaces": {
            "description": "Workspaces and organizations this user may access.\nNote\\: The API will only return workspaces and organizations that also contain the authenticated user.",
            "items": {
              "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
              "properties": {
                "gid": {
                  "description": "Globally unique identifier of the resource, as a string.",
                  "example": "12345",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": false
                },
                "name": {
                  "description": "The name of the workspace.",
                  "example": "My Company Workspace",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The base type of this resource.",
                  "example": "task",
                  "readOnly": true,
                  "type": "string",
                  "x-insert-after": "gid"
                }
              },
              "type": "object",
              "x-docs-overrides": {
                "properties.resource_type.example": "workspace"
              }
            },
            "readOnly": true,
            "type": "array"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "user"
        }
      },
      "sdk__UserResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__UserResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__UserResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__UserResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__UserTaskListBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA user task list represents the tasks assigned to a particular user. It provides API access to a user’s [My tasks](https://asana.com/guide/help/fundamentals/my-tasks) view in Asana.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the user task list.",
            "example": "My tasks in My Workspace",
            "type": "string"
          },
          "owner": {
            "allOf": [
              {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              }
            ],
            "description": "The owner of the user task list, i.e. the person whose My Tasks is represented by this resource.",
            "readOnly": true
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "workspace": {
            "allOf": [
              {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the workspace.",
                    "example": "My Company Workspace",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "workspace"
                }
              }
            ],
            "description": "The workspace in which the user task list is located.",
            "readOnly": true
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "user_task_list"
        }
      },
      "sdk__UserTaskListCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA user task list represents the tasks assigned to a particular user. It provides API access to a user’s [My tasks](https://asana.com/guide/help/fundamentals/my-tasks) view in Asana.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the user task list.",
            "example": "My tasks in My Workspace",
            "type": "string"
          },
          "owner": {
            "allOf": [
              {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              }
            ],
            "description": "The owner of the user task list, i.e. the person whose My Tasks is represented by this resource.",
            "readOnly": true
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "workspace": {
            "allOf": [
              {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the workspace.",
                    "example": "My Company Workspace",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "workspace"
                }
              }
            ],
            "description": "The workspace in which the user task list is located.",
            "readOnly": true
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "user_task_list"
        }
      },
      "sdk__UserTaskListRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA user task list represents the tasks assigned to a particular user. It provides API access to a user’s [My tasks](https://asana.com/guide/help/fundamentals/my-tasks) view in Asana.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the user task list.",
            "example": "My tasks in My Workspace",
            "type": "string"
          },
          "owner": {
            "allOf": [
              {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              }
            ],
            "description": "The owner of the user task list, i.e. the person whose My Tasks is represented by this resource.",
            "readOnly": true
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "workspace": {
            "allOf": [
              {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the workspace.",
                    "example": "My Company Workspace",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "workspace"
                }
              }
            ],
            "description": "The workspace in which the user task list is located.",
            "readOnly": true
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "user_task_list"
        }
      },
      "sdk__UserTaskListResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA user task list represents the tasks assigned to a particular user. It provides API access to a user’s [My tasks](https://asana.com/guide/help/fundamentals/my-tasks) view in Asana.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the user task list.",
            "example": "My tasks in My Workspace",
            "type": "string"
          },
          "owner": {
            "allOf": [
              {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "*Read-only except when same user as requester*. The user's name.",
                    "example": "Greg Sanchez",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "user"
                }
              }
            ],
            "description": "The owner of the user task list, i.e. the person whose My Tasks is represented by this resource.",
            "readOnly": true
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "workspace": {
            "allOf": [
              {
                "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
                "properties": {
                  "gid": {
                    "description": "Globally unique identifier of the resource, as a string.",
                    "example": "12345",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": false
                  },
                  "name": {
                    "description": "The name of the workspace.",
                    "example": "My Company Workspace",
                    "type": "string"
                  },
                  "resource_type": {
                    "description": "The base type of this resource.",
                    "example": "task",
                    "readOnly": true,
                    "type": "string",
                    "x-insert-after": "gid"
                  }
                },
                "type": "object",
                "x-docs-overrides": {
                  "properties.resource_type.example": "workspace"
                }
              }
            ],
            "description": "The workspace in which the user task list is located.",
            "readOnly": true
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "user_task_list"
        }
      },
      "sdk__UserTaskListResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__UserTaskListResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__UserUpdateRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
        "properties": {
          "custom_fields": {
            "additionalProperties": {
              "description": "\"{custom_field_gid}\" => Value (can be text, enum GID, a number, etc.). For date, use format \"YYYY-MM-DD\" (e.g., 2019-09-15). For date-time, use ISO 8601 date string in UTC (e.g., 2019-09-15T02:06:58.147Z).",
              "type": "string"
            },
            "description": "An object where each key is the GID of a custom field and its corresponding value is either an enum GID, string, number, or object (depending on the custom field type). See the [custom fields guide](/docs/custom-fields-guide) for details on creating and updating custom field values.",
            "example": {
              "4578152156": "Not Started",
              "5678904321": "On Hold"
            },
            "type": "object"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "html_custom_fields": {
            "additionalProperties": {
              "description": "\"{custom_field_gid}\" => HTML string (e.g., \"<body>Text content</body>\")",
              "type": "string"
            },
            "description": "An object where each key is the GID of a text custom field and the corresponding value is a rich text HTML string. Only text-type custom fields support this parameter. Values must be wrapped in <body></body> tags. See the [custom fields guide](/docs/custom-fields-guide) and [rich text](/docs/rich-text) for details on supported formatting.",
            "example": {
              "4578152156": "<body><code>Code block</code></body>",
              "5678904321": "<body><strong>Bold text</strong></body>"
            },
            "type": "object"
          },
          "name": {
            "description": "*Read-only except when same user as requester*. The user's name.",
            "example": "Greg Sanchez",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "user"
        }
      },
      "sdk__WebhookCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nWebhook objects represent the state of an active subscription for a server to be updated with information from Asana. This schema represents the subscription itself, not the objects that are sent to the server. For information on those please refer to the [event](/reference/events) schema.",
        "properties": {
          "active": {
            "description": "If true, the webhook will send events - if false it is considered inactive and will not generate events.",
            "example": false,
            "readOnly": true,
            "type": "boolean"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource": {
            "description": "A generic Asana Resource, containing a globally unique identifier.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the object.",
                "example": "Bug Task",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "target": {
            "description": "The URL to receive the HTTP POST.",
            "example": "https://example.com/receive-webhook/7654",
            "format": "uri",
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "webhook"
        }
      },
      "sdk__WebhookFilter": {
        "description": "A WebhookFilter can be passed on creation of a webhook in order to filter the types of actions that trigger delivery of an [event](/reference/events)",
        "properties": {
          "action": {
            "description": "The type of change on the **resource** to pass through the filter. For more information refer to `Event.action` in the [event](/reference/events) schema. This can be one of `changed`, `added`, `removed`, `deleted`, and `undeleted` depending on the nature of what has occurred on the resource.",
            "example": "changed",
            "type": "string"
          },
          "fields": {
            "description": "*Conditional.* A whitelist of fields for events which will pass the filter when the resource is changed. These can be any combination of the fields on the resources themselves. This field is only valid for `action` of type `changed`\n*Note: Subscriptions created on higher-level resources such as a Workspace, Team, or Portfolio do not support fields.*",
            "example": [
              "due_at",
              "due_on",
              "dependencies"
            ],
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "resource_subtype": {
            "description": "The resource subtype of the resource that the filter applies to. This should be set to the same value as is returned on the `resource_subtype` field on the resources themselves.",
            "example": "milestone",
            "type": "string"
          },
          "resource_type": {
            "description": "The type of the resource which created the event when modified; for example, to filter to changes on regular tasks this field should be set to `task`.",
            "example": "task",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__WebhookRequest": {
        "properties": {
          "filters": {
            "description": "An array of WebhookFilter objects to specify a whitelist of filters to apply to events from this webhook. If a webhook event passes any of the filters the event will be delivered; otherwise no event will be sent to the receiving server.",
            "items": {
              "description": "A WebhookFilter can be passed on creation of a webhook in order to filter the types of actions that trigger delivery of an [event](/reference/events)A WebhookFilter can be passed on creation of a webhook in order to filter the types of actions that trigger delivery of an [event](/reference/events)\nA set of filters to specify a whitelist for what types of events will be delivered.",
              "properties": {
                "action": {
                  "description": "The type of change on the **resource** to pass through the filter. For more information refer to `Event.action` in the [event](/reference/events) schema. This can be one of `changed`, `added`, `removed`, `deleted`, and `undeleted` depending on the nature of what has occurred on the resource.",
                  "example": "changed",
                  "type": "string"
                },
                "fields": {
                  "description": "*Conditional.* A whitelist of fields for events which will pass the filter when the resource is changed. These can be any combination of the fields on the resources themselves. This field is only valid for `action` of type `changed`\n*Note: Subscriptions created on higher-level resources such as a Workspace, Team, or Portfolio do not support fields.*",
                  "example": [
                    "due_at",
                    "due_on",
                    "dependencies"
                  ],
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "resource_subtype": {
                  "description": "The resource subtype of the resource that the filter applies to. This should be set to the same value as is returned on the `resource_subtype` field on the resources themselves.",
                  "example": "milestone",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The type of the resource which created the event when modified; for example, to filter to changes on regular tasks this field should be set to `task`.",
                  "example": "task",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "resource": {
            "description": "A resource ID to subscribe to. Many Asana resources are valid to create webhooks on, but higher-level resources require filters.",
            "example": "12345",
            "type": "string"
          },
          "target": {
            "description": "The URL to receive the HTTP POST. The full URL will be used to deliver events from this webhook (including parameters) which allows encoding of application-specific state when the webhook is created.",
            "example": "https://example.com/receive-webhook/7654?app_specific_param=app_specific_value",
            "format": "uri",
            "type": "string"
          }
        },
        "required": [
          "resource",
          "target"
        ],
        "type": "object"
      },
      "sdk__WebhookResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nWebhook objects represent the state of an active subscription for a server to be updated with information from Asana. This schema represents the subscription itself, not the objects that are sent to the server. For information on those please refer to the [event](/reference/events) schema.",
        "properties": {
          "active": {
            "description": "If true, the webhook will send events - if false it is considered inactive and will not generate events.",
            "example": false,
            "readOnly": true,
            "type": "boolean"
          },
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "delivery_retry_count": {
            "description": "The number of times the webhook has retried delivery of events to the target (resets after a successful attempt).",
            "example": 3,
            "readOnly": true,
            "type": "integer"
          },
          "failure_deletion_timestamp": {
            "description": "The timestamp when the webhook will be deleted if there is no successful attempt to deliver events to the target",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "filters": {
            "description": "Whitelist of filters to apply to events from this webhook. If a webhook event passes any of the filters the event will be delivered; otherwise no event will be sent to the receiving server.",
            "items": {
              "description": "A WebhookFilter can be passed on creation of a webhook in order to filter the types of actions that trigger delivery of an [event](/reference/events)A WebhookFilter can be passed on creation of a webhook in order to filter the types of actions that trigger delivery of an [event](/reference/events)\nA set of filters to specify a whitelist for what types of events will be delivered.",
              "properties": {
                "action": {
                  "description": "The type of change on the **resource** to pass through the filter. For more information refer to `Event.action` in the [event](/reference/events) schema. This can be one of `changed`, `added`, `removed`, `deleted`, and `undeleted` depending on the nature of what has occurred on the resource.",
                  "example": "changed",
                  "type": "string"
                },
                "fields": {
                  "description": "*Conditional.* A whitelist of fields for events which will pass the filter when the resource is changed. These can be any combination of the fields on the resources themselves. This field is only valid for `action` of type `changed`\n*Note: Subscriptions created on higher-level resources such as a Workspace, Team, or Portfolio do not support fields.*",
                  "example": [
                    "due_at",
                    "due_on",
                    "dependencies"
                  ],
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "resource_subtype": {
                  "description": "The resource subtype of the resource that the filter applies to. This should be set to the same value as is returned on the `resource_subtype` field on the resources themselves.",
                  "example": "milestone",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The type of the resource which created the event when modified; for example, to filter to changes on regular tasks this field should be set to `task`.",
                  "example": "task",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "last_failure_at": {
            "description": "The timestamp when the webhook last received an error when sending an event to the target.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "last_failure_content": {
            "description": "The contents of the last error response sent to the webhook when attempting to deliver events to the target.",
            "example": "500 Server Error\\n\\nCould not complete the request",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "last_success_at": {
            "description": "The timestamp when the webhook last successfully sent an event to the target.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "next_attempt_after": {
            "description": "The timestamp after which the webhook will next attempt to deliver an event to the target.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "resource": {
            "description": "A generic Asana Resource, containing a globally unique identifier.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the object.",
                "example": "Bug Task",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "target": {
            "description": "The URL to receive the HTTP POST.",
            "example": "https://example.com/receive-webhook/7654",
            "format": "uri",
            "readOnly": true,
            "type": "string"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "webhook"
        }
      },
      "sdk__WebhookResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__WebhookResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__WebhookResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__WebhookResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__WebhookUpdateRequest": {
        "properties": {
          "filters": {
            "description": "An array of WebhookFilter objects to specify a whitelist of filters to apply to events from this webhook. If a webhook event passes any of the filters the event will be delivered; otherwise no event will be sent to the receiving server.",
            "items": {
              "description": "A WebhookFilter can be passed on creation of a webhook in order to filter the types of actions that trigger delivery of an [event](/reference/events)A WebhookFilter can be passed on creation of a webhook in order to filter the types of actions that trigger delivery of an [event](/reference/events)\nA set of filters to specify a whitelist for what types of events will be delivered.",
              "properties": {
                "action": {
                  "description": "The type of change on the **resource** to pass through the filter. For more information refer to `Event.action` in the [event](/reference/events) schema. This can be one of `changed`, `added`, `removed`, `deleted`, and `undeleted` depending on the nature of what has occurred on the resource.",
                  "example": "changed",
                  "type": "string"
                },
                "fields": {
                  "description": "*Conditional.* A whitelist of fields for events which will pass the filter when the resource is changed. These can be any combination of the fields on the resources themselves. This field is only valid for `action` of type `changed`\n*Note: Subscriptions created on higher-level resources such as a Workspace, Team, or Portfolio do not support fields.*",
                  "example": [
                    "due_at",
                    "due_on",
                    "dependencies"
                  ],
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "resource_subtype": {
                  "description": "The resource subtype of the resource that the filter applies to. This should be set to the same value as is returned on the `resource_subtype` field on the resources themselves.",
                  "example": "milestone",
                  "type": "string"
                },
                "resource_type": {
                  "description": "The type of the resource which created the event when modified; for example, to filter to changes on regular tasks this field should be set to `task`.",
                  "example": "task",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "sdk__WorkspaceAddUserRequest": {
        "description": "A user identification object for specification with the addUser/removeUser endpoints.",
        "properties": {
          "user": {
            "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
            "example": "12345",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__WorkspaceBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the workspace.",
            "example": "My Company Workspace",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "workspace"
        }
      },
      "sdk__WorkspaceCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the workspace.",
            "example": "My Company Workspace",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "workspace"
        }
      },
      "sdk__WorkspaceMembershipBase": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object determines if a user is a member of a workspace.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "user": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "workspace": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the workspace.",
                "example": "My Company Workspace",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "workspace"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "workspace_membership"
        }
      },
      "sdk__WorkspaceMembershipCompact": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object determines if a user is a member of a workspace.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "user": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "workspace": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the workspace.",
                "example": "My Company Workspace",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "workspace"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "workspace_membership"
        }
      },
      "sdk__WorkspaceMembershipRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object determines if a user is a member of a workspace.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "user": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "workspace": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the workspace.",
                "example": "My Company Workspace",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "workspace"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "workspace_membership"
        }
      },
      "sdk__WorkspaceMembershipResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nThis object determines if a user is a member of a workspace.",
        "properties": {
          "created_at": {
            "description": "The time at which this resource was created.",
            "example": "2012-02-22T02:06:58.147Z",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "is_active": {
            "description": "Indicates whether the user is currently associated with the workspace. Returns `true` for users who have joined the workspace or have been invited but not yet accepted.",
            "readOnly": true,
            "type": "boolean"
          },
          "is_admin": {
            "description": "Reflects if this user is an admin of the workspace.",
            "readOnly": true,
            "type": "boolean"
          },
          "is_guest": {
            "description": "Reflects if this user is a guest of the workspace.",
            "readOnly": true,
            "type": "boolean"
          },
          "is_view_only": {
            "description": "Reflects if this user has view only license in the workspace.",
            "readOnly": true,
            "type": "boolean"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          },
          "user": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "*Read-only except when same user as requester*. The user's name.",
                "example": "Greg Sanchez",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user"
            }
          },
          "user_task_list": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA user task list represents the tasks assigned to a particular user. It provides API access to a user’s [My tasks](https://asana.com/guide/help/fundamentals/my-tasks) view in Asana.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the user task list.",
                "example": "My tasks in My Workspace",
                "type": "string"
              },
              "owner": {
                "allOf": [
                  {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                    "properties": {
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "*Read-only except when same user as requester*. The user's name.",
                        "example": "Greg Sanchez",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "user"
                    }
                  }
                ],
                "description": "The owner of the user task list, i.e. the person whose My Tasks is represented by this resource.",
                "readOnly": true
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              },
              "workspace": {
                "allOf": [
                  {
                    "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
                    "properties": {
                      "gid": {
                        "description": "Globally unique identifier of the resource, as a string.",
                        "example": "12345",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": false
                      },
                      "name": {
                        "description": "The name of the workspace.",
                        "example": "My Company Workspace",
                        "type": "string"
                      },
                      "resource_type": {
                        "description": "The base type of this resource.",
                        "example": "task",
                        "readOnly": true,
                        "type": "string",
                        "x-insert-after": "gid"
                      }
                    },
                    "type": "object",
                    "x-docs-overrides": {
                      "properties.resource_type.example": "workspace"
                    }
                  }
                ],
                "description": "The workspace in which the user task list is located.",
                "readOnly": true
              }
            },
            "readOnly": true,
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "user_task_list"
            }
          },
          "vacation_dates": {
            "deprecated": true,
            "description": "*Deprecated:* Use the [`/ooo_entries`](/reference/getoooentries) endpoints instead. Contains keys `start_on` and `end_on` for the vacation dates for the user in this workspace. If `start_on` is null, the entire `vacation_dates` object will be null. If `end_on` is before today, the entire `vacation_dates` object will be null.",
            "nullable": true,
            "properties": {
              "end_on": {
                "deprecated": true,
                "description": "*Deprecated:* Use the [`/ooo_entries`](/reference/getoooentries) endpoints instead. The day on which the user's vacation in this workspace ends, or null if there is no end date. This is a date with `YYYY-MM-DD` format.",
                "example": "2022-11-07",
                "nullable": true,
                "type": "string"
              },
              "start_on": {
                "deprecated": true,
                "description": "*Deprecated:* Use the [`/ooo_entries`](/reference/getoooentries) endpoints instead. The day on which the user's vacation in this workspace starts. This is a date with `YYYY-MM-DD` format.",
                "example": "2022-11-05",
                "type": "string"
              }
            },
            "readOnly": true,
            "type": "object"
          },
          "workspace": {
            "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
            "properties": {
              "gid": {
                "description": "Globally unique identifier of the resource, as a string.",
                "example": "12345",
                "readOnly": true,
                "type": "string",
                "x-insert-after": false
              },
              "name": {
                "description": "The name of the workspace.",
                "example": "My Company Workspace",
                "type": "string"
              },
              "resource_type": {
                "description": "The base type of this resource.",
                "example": "task",
                "readOnly": true,
                "type": "string",
                "x-insert-after": "gid"
              }
            },
            "type": "object",
            "x-docs-overrides": {
              "properties.resource_type.example": "workspace"
            }
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "workspace_membership"
        }
      },
      "sdk__WorkspaceMembershipResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__WorkspaceMembershipResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__WorkspaceMembershipResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__WorkspaceMembershipResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__WorkspaceRemoveUserRequest": {
        "description": "A user identification object for specification with the addUser/removeUser endpoints.",
        "properties": {
          "user": {
            "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
            "example": "12345",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sdk__WorkspaceRequest": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
        "properties": {
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "name": {
            "description": "The name of the workspace.",
            "example": "My Company Workspace",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "workspace"
        }
      },
      "sdk__WorkspaceResponse": {
        "description": "A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.\nA *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.",
        "properties": {
          "email_domains": {
            "description": "The email domains that are associated with this workspace.",
            "example": [
              "asana.com"
            ],
            "items": {
              "format": "uri",
              "type": "string"
            },
            "type": "array"
          },
          "gid": {
            "description": "Globally unique identifier of the resource, as a string.",
            "example": "12345",
            "readOnly": true,
            "type": "string",
            "x-insert-after": false
          },
          "is_organization": {
            "description": "Whether the workspace is an *organization*.",
            "example": false,
            "type": "boolean"
          },
          "name": {
            "description": "The name of the workspace.",
            "example": "My Company Workspace",
            "type": "string"
          },
          "resource_type": {
            "description": "The base type of this resource.",
            "example": "task",
            "readOnly": true,
            "type": "string",
            "x-insert-after": "gid"
          }
        },
        "type": "object",
        "x-docs-overrides": {
          "properties.resource_type.example": "workspace"
        }
      },
      "sdk__WorkspaceResponseArray": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/sdk__WorkspaceResponse"
            },
            "type": "array"
          },
          "next_page": {
            "$ref": "#/components/schemas/sdk__NextPage"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "sdk__WorkspaceResponseData": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/sdk__WorkspaceResponse"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      }
    },
    "securitySchemes": {
      "oauth2": {
        "description": "We require that applications designed to access the Asana API on behalf of multiple users implement OAuth 2.0.\nAsana supports the Authorization Code Grant flow.",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://app.asana.com/-/oauth_authorize",
            "refreshUrl": "https://app.asana.com/-/oauth_token",
            "scopes": {
              "attachments:delete": "Delete access to attachments",
              "attachments:read": "View access to attachments",
              "attachments:write": "Create and modify access to attachments",
              "custom_fields:read": "View access to custom fields",
              "custom_fields:write": "Create and modify access to custom fields",
              "custom_types:read": "View access to custom types",
              "default": "Provides access to all endpoints documented in our API reference. If no scopes are requested, this scope is assumed by default.",
              "email": "Provides access to the user’s email through the OpenID Connect user info endpoint.",
              "goals:read": "View access to goals",
              "jobs:read": "View access to jobs",
              "notifications:read": "View access to notifications",
              "notifications:write": "Create and modify access to notifications",
              "ooo_entries:delete": "Delete access to OOO entries",
              "ooo_entries:read": "View access to OOO entries",
              "ooo_entries:write": "Create and modify access to OOO entries",
              "openid": "Provides access to OpenID Connect ID tokens and the OpenID Connect user info endpoint.",
              "portfolios:read": "View access to portfolios",
              "portfolios:write": "Create and modify access to portfolios",
              "profile": "Provides access to the user’s name and profile photo through the OpenID Connect user info endpoint.",
              "project_portfolio_settings:read": "View access to project portfolio settings",
              "project_portfolio_settings:write": "Create and modify access to project portfolio settings",
              "project_templates:read": "View access to project templates",
              "projects:delete": "Delete access to projects",
              "projects:read": "View access to projects",
              "projects:write": "Create and modify access to projects",
              "records:delete": "Delete access to records",
              "records:read": "View access to records",
              "records:write": "Create and modify access to records",
              "roles:delete": "Delete access to roles",
              "roles:read": "View access to roles",
              "roles:write": "Create and modify access to roles",
              "stories:read": "View access to stories",
              "stories:write": "Create and modify access to stories",
              "tables:delete": "Delete access to tables",
              "tables:read": "View access to tables",
              "tables:write": "Create and modify access to tables",
              "tags:read": "View access to tags",
              "tags:write": "Create and modify access to tags",
              "task_custom_types:read": "View access to task custom types",
              "task_templates:read": "View access to task templates",
              "tasks:delete": "Delete access to tasks",
              "tasks:read": "View access to tasks",
              "tasks:write": "Create and modify access to tasks",
              "team_memberships:read": "View access to team memberships",
              "teams:read": "View access to teams",
              "time_tracking_categories:delete": "Delete access to time tracking categories",
              "time_tracking_categories:read": "View access to time tracking categories",
              "time_tracking_categories:write": "Create and modify access to time tracking categories",
              "time_tracking_entries:read": "View access to time tracking entries",
              "timesheet_approval_statuses:read": "View access to timesheet approval statuses",
              "timesheet_approval_statuses:write": "Create and modify access to timesheet approval statuses",
              "users:read": "View access to users",
              "webhooks:delete": "Delete access to webhooks",
              "webhooks:read": "View access to webhooks",
              "webhooks:write": "Create and modify access to webhooks",
              "workspaces:read": "View access to workspaces"
            },
            "tokenUrl": "https://app.asana.com/-/oauth_token"
          }
        },
        "type": "oauth2"
      },
      "personalAccessToken": {
        "description": "A personal access token allows access to the api for the user who created it. This should be kept a secret and be treated like a password.",
        "scheme": "bearer",
        "type": "http"
      },
      "sdk__personalAccessToken": {
        "description": "A personal access token allows access to the api for the user who created it. This should be kept a secret and be treated like a password.",
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "contact": {
      "name": "Asana Support",
      "url": "https://asana.com/support"
    },
    "description": "This is the interface for interacting with the [Asana Platform](https://developers.asana.com). Our API reference is generated from our [OpenAPI spec] (https://raw.githubusercontent.com/Asana/openapi/master/defs/asana_oas.yaml).",
    "license": {
      "name": "Apache 2.0",
      "url": "https://www.apache.org/licenses/LICENSE-2.0"
    },
    "termsOfService": "https://asana.com/terms",
    "title": "Asana",
    "version": "1.0",
    "x-docs-schema-whitelist": [
      "AgentCompact",
      "AgentResponse",
      "AsanaResource",
      "AsanaNamedResource",
      "AuditLogEvent",
      "AttachmentResponse",
      "AttachmentCompact",
      "BatchResponse",
      "CustomFieldSettingResponse",
      "CustomFieldSettingCompact",
      "CustomTypeResponse",
      "CustomTypeBase",
      "CustomTypeCompact",
      "CustomTypeStatusOptionResponse",
      "CustomTypeStatusOptionBase",
      "CustomTypeStatusOptionCompact",
      "CustomFieldResponse",
      "CustomFieldCompact",
      "CustomFieldMembershipCompact",
      "CustomFieldMembershipResponse",
      "EnumOption",
      "EventResponse",
      "ErrorResponse",
      "GoalResponse",
      "GoalCompact",
      "GoalMembershipCompact",
      "GoalMembershipBase",
      "GoalMembershipResponse",
      "GoalRelationshipResponse",
      "GoalRelationshipCompact",
      "GraphExportResponse",
      "GraphExportCompact",
      "JobResponse",
      "JobCompact",
      "OrganizationExportResponse",
      "OrganizationExportCompact",
      "PortfolioMembershipResponse",
      "PortfolioMembershipCompact",
      "PortfolioResponse",
      "PortfolioCompact",
      "PortfolioItemCompact",
      "ProjectBriefResponse",
      "ProjectBriefCompact",
      "ProjectMembershipCompactResponse",
      "ProjectMembershipNormalResponse",
      "ProjectMembershipCompact",
      "ProjectResponse",
      "ProjectCompact",
      "ProjectStatusResponse",
      "ProjectStatusCompact",
      "ProjectTemplateCompact",
      "ProjectTemplateResponse",
      "RuleTriggerResponse",
      "ResourceExportResponse",
      "ResourceExportCompact",
      "ResourceExportCompact",
      "RbacRoleResponse",
      "RbacRoleCompact",
      "SectionResponse",
      "SectionCompact",
      "StatusUpdateResponse",
      "StatusUpdateCompact",
      "StoryResponse",
      "StoryCompact",
      "TagResponse",
      "TagCompact",
      "TaskResponse",
      "TaskCompact",
      "TaskCountResponse",
      "TeamMembershipResponse",
      "TeamMembershipCompact",
      "TeamResponse",
      "TeamCompact",
      "TimePeriodResponse",
      "TimePeriodCompact",
      "TimeTrackingCategoryResponse",
      "TimeTrackingCategoryCompact",
      "UserTaskListResponse",
      "UserTaskListCompact",
      "UserResponse",
      "UserCompact",
      "WebhookFilter",
      "WebhookResponse",
      "WebhookCompact",
      "WorkspaceMembershipResponse",
      "WorkspaceMembershipCompact",
      "WorkspaceResponse",
      "WorkspaceCompact"
    ],
    "x-public-description": "This is the interface for interacting with the [Asana Platform](https://developers.asana.com). Our API reference is generated from our [OpenAPI spec] (https://raw.githubusercontent.com/Asana/openapi/master/defs/asana_oas.yaml)."
  },
  "openapi": "3.0.0",
  "paths": {
    "/access_requests": {
      "get": {
        "description": "Returns the pending access requests for a target object or a target object filtered by user.",
        "operationId": "getAccessRequests",
        "parameters": [
          {
            "$ref": "#/components/parameters/target_query_param"
          },
          {
            "$ref": "#/components/parameters/user_query_param"
          },
          {
            "$ref": "#/components/parameters/pretty"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "approval_status",
              "message",
              "requester",
              "requester.name",
              "target"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "approval_status",
                  "message",
                  "requester",
                  "requester.name",
                  "target"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/AccessRequestResponse"
                          },
                          "type": "array"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__AccessRequestResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved access requests."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get access requests",
        "tags": [
          "Access requests"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1access_requests/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet accessRequestsApiInstance = new Asana.AccessRequestsApi(client);\nlet target = \"1331\"; // String | Globally unique identifier for the target object.\nlet opts = { \n    'user': \"me\", \n    'opt_fields': \"approval_status,message,requester,requester.name,target\"\n};\naccessRequestsApiInstance.getAccessRequests(target, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\naccess_requests_api_instance = asana.AccessRequestsApi(api_client)\ntarget = \"1331\" # str | Globally unique identifier for the target object.\nopts = {\n    'user': \"me\", # str | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\n    'opt_fields': \"approval_status,message,requester,requester.name,target\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get access requests\n    api_response = access_requests_api_instance.get_access_requests(target, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling AccessRequestsApi->get_access_requests: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "post": {
        "description": "Submits a new access request for a private object. Currently supports projects and portfolios.",
        "operationId": "createAccessRequest",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/AccessRequestCreateRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/AccessRequestResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__AccessRequestResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created a new access request."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Create an access request",
        "tags": [
          "Access requests"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1access_requests/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet accessRequestsApiInstance = new Asana.AccessRequestsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | \n\naccessRequestsApiInstance.createAccessRequest(body).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\naccess_requests_api_instance = asana.AccessRequestsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | \n\n\ntry:\n    # Create an access request\n    api_response = access_requests_api_instance.create_access_request(body)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling AccessRequestsApi->create_access_request: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/access_requests/{access_request_gid}/approve": {},
    "/access_requests/{access_request_gid}/reject": {
      "post": {
        "description": "Rejects an access request for a target object.",
        "operationId": "rejectAccessRequest",
        "parameters": [
          {
            "$ref": "#/components/parameters/access_request_gid"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully rejected an access request."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Reject an access request",
        "tags": [
          "Access requests"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1access_requests~1{access_request_gid}~1reject/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet accessRequestsApiInstance = new Asana.AccessRequestsApi(client);\nlet access_request_gid = \"12345\"; // String | Globally unique identifier for the access request.\n\naccessRequestsApiInstance.rejectAccessRequest(access_request_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\naccess_requests_api_instance = asana.AccessRequestsApi(api_client)\naccess_request_gid = \"12345\" # str | Globally unique identifier for the access request.\n\n\ntry:\n    # Reject an access request\n    api_response = access_requests_api_instance.reject_access_request(access_request_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling AccessRequestsApi->reject_access_request: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/agents/{agent_gid}": {
      "get": {
        "description": "Returns the complete record for a single agent (AI Teammate).",
        "operationId": "getAgent",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "behavior_guidance",
              "description",
              "name",
              "photo",
              "photo.image_1024x1024",
              "photo.image_128x128",
              "photo.image_21x21",
              "photo.image_27x27",
              "photo.image_36x36",
              "photo.image_60x60",
              "resource_subtype",
              "workspace"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "behavior_guidance",
                  "description",
                  "name",
                  "photo",
                  "photo.image_1024x1024",
                  "photo.image_128x128",
                  "photo.image_21x21",
                  "photo.image_27x27",
                  "photo.image_36x36",
                  "photo.image_60x60",
                  "resource_subtype",
                  "workspace"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/AgentResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__AgentResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested agent."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get an agent",
        "tags": [
          "Agents"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1agents~1{agent_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet agentsApiInstance = new Asana.AgentsApi(client);\nlet agent_gid = \"12345\"; // String | Globally unique identifier for the agent.\nlet opts = { \n    'opt_fields': \"behavior_guidance,description,name,photo,photo.image_1024x1024,photo.image_128x128,photo.image_21x21,photo.image_27x27,photo.image_36x36,photo.image_60x60,resource_subtype,workspace\"\n};\nagentsApiInstance.getAgent(agent_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nagents_api_instance = asana.AgentsApi(api_client)\nagent_gid = \"12345\" # str | Globally unique identifier for the agent.\nopts = {\n    'opt_fields': \"behavior_guidance,description,name,photo,photo.image_1024x1024,photo.image_128x128,photo.image_21x21,photo.image_27x27,photo.image_36x36,photo.image_60x60,resource_subtype,workspace\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get an agent\n    api_response = agents_api_instance.get_agent(agent_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling AgentsApi->get_agent: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/agent_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/allocations": {
      "get": {
        "description": "Returns a list of allocations filtered to a specific project, user or placeholder.",
        "operationId": "getAllocations",
        "parameters": [
          {
            "description": "Globally unique identifier for the project to filter allocations by.",
            "example": "77688",
            "in": "query",
            "name": "parent",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Globally unique identifier for the user or placeholder the allocation is assigned to.",
            "example": "12345",
            "in": "query",
            "name": "assignee",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Globally unique identifier for the workspace.",
            "example": "98765",
            "in": "query",
            "name": "workspace",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "assignee",
              "assignee.name",
              "created_by",
              "created_by.name",
              "effort",
              "effort.type",
              "effort.value",
              "end_date",
              "offset",
              "parent",
              "parent.name",
              "parent.resource_subtype",
              "path",
              "resource_subtype",
              "start_date",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "assignee",
                  "assignee.name",
                  "created_by",
                  "created_by.name",
                  "effort",
                  "effort.type",
                  "effort.value",
                  "end_date",
                  "offset",
                  "parent",
                  "parent.name",
                  "parent.resource_subtype",
                  "path",
                  "resource_subtype",
                  "start_date",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/AllocationResponse"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__AllocationResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested allocations."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get multiple allocations",
        "tags": [
          "Allocations"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1allocations/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet allocationsApiInstance = new Asana.AllocationsApi(client);\nlet opts = { \n    'parent': \"77688\", \n    'assignee': \"12345\", \n    'workspace': \"98765\", \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"assignee,assignee.name,created_by,created_by.name,effort,effort.type,effort.value,end_date,offset,parent,parent.name,parent.resource_subtype,path,resource_subtype,start_date,uri\"\n};\nallocationsApiInstance.getAllocations(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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.allocations.getAllocations({param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nallocations_api_instance = asana.AllocationsApi(api_client)\nopts = {\n    'parent': \"77688\", # str | Globally unique identifier for the project to filter allocations by.\n    'assignee': \"12345\", # str | Globally unique identifier for the user or placeholder the allocation is assigned to.\n    'workspace': \"98765\", # str | Globally unique identifier for the workspace.\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    'opt_fields': \"assignee,assignee.name,created_by,created_by.name,effort,effort.type,effort.value,end_date,offset,parent,parent.name,parent.resource_subtype,path,resource_subtype,start_date,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get multiple allocations\n    api_response = allocations_api_instance.get_allocations(opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling AllocationsApi->get_allocations: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.allocations.get_allocations({'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "Creates a new allocation.\n\nReturns the full record of the newly created allocation.",
        "operationId": "createAllocation",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "assignee",
              "assignee.name",
              "created_by",
              "created_by.name",
              "effort",
              "effort.type",
              "effort.value",
              "end_date",
              "parent",
              "parent.name",
              "parent.resource_subtype",
              "resource_subtype",
              "start_date"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "assignee",
                  "assignee.name",
                  "created_by",
                  "created_by.name",
                  "effort",
                  "effort.type",
                  "effort.value",
                  "end_date",
                  "parent",
                  "parent.name",
                  "parent.resource_subtype",
                  "resource_subtype",
                  "start_date"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/AllocationRequest"
                      },
                      {
                        "required": [
                          "assignee",
                          "end_date",
                          "parent",
                          "start_date"
                        ],
                        "type": "object"
                      }
                    ]
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The allocation to create.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/AllocationResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__AllocationResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created a new allocation."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Create an allocation",
        "tags": [
          "Allocations"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1allocations/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet allocationsApiInstance = new Asana.AllocationsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The allocation to create.\nlet opts = { \n    'opt_fields': \"assignee,assignee.name,created_by,created_by.name,effort,effort.type,effort.value,end_date,parent,parent.name,parent.resource_subtype,resource_subtype,start_date\"\n};\nallocationsApiInstance.createAllocation(body, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.allocations.createAllocation({field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nallocations_api_instance = asana.AllocationsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The allocation to create.\nopts = {\n    'opt_fields': \"assignee,assignee.name,created_by,created_by.name,effort,effort.type,effort.value,end_date,parent,parent.name,parent.resource_subtype,resource_subtype,start_date\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create an allocation\n    api_response = allocations_api_instance.create_allocation(body, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling AllocationsApi->create_allocation: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.allocations.create_allocation({'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            }
          ]
        }
      }
    },
    "/allocations/{allocation_gid}": {
      "delete": {
        "description": "A specific, existing allocation can be deleted by making a DELETE request on the URL for that allocation.\n\nReturns an empty data record.",
        "operationId": "deleteAllocation",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully deleted the specified allocation."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Delete an allocation",
        "tags": [
          "Allocations"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1allocations~1{allocation_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet allocationsApiInstance = new Asana.AllocationsApi(client);\nlet allocation_gid = \"77688\"; // String | Globally unique identifier for the allocation.\n\nallocationsApiInstance.deleteAllocation(allocation_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.allocations.deleteAllocation(allocationGid)\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nallocations_api_instance = asana.AllocationsApi(api_client)\nallocation_gid = \"77688\" # str | Globally unique identifier for the allocation.\n\n\ntry:\n    # Delete an allocation\n    api_response = allocations_api_instance.delete_allocation(allocation_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling AllocationsApi->delete_allocation: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.allocations.delete_allocation(allocation_gid, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            }
          ]
        }
      },
      "get": {
        "description": "Returns the complete allocation record for a single allocation.",
        "operationId": "getAllocation",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "assignee",
              "assignee.name",
              "created_by",
              "created_by.name",
              "effort",
              "effort.type",
              "effort.value",
              "end_date",
              "parent",
              "parent.name",
              "parent.resource_subtype",
              "resource_subtype",
              "start_date"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "assignee",
                  "assignee.name",
                  "created_by",
                  "created_by.name",
                  "effort",
                  "effort.type",
                  "effort.value",
                  "end_date",
                  "parent",
                  "parent.name",
                  "parent.resource_subtype",
                  "resource_subtype",
                  "start_date"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/AllocationResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__AllocationResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the record for a single allocation."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get an allocation",
        "tags": [
          "Allocations"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1allocations~1{allocation_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet allocationsApiInstance = new Asana.AllocationsApi(client);\nlet allocation_gid = \"77688\"; // String | Globally unique identifier for the allocation.\nlet opts = { \n    'opt_fields': \"assignee,assignee.name,created_by,created_by.name,effort,effort.type,effort.value,end_date,parent,parent.name,parent.resource_subtype,resource_subtype,start_date\"\n};\nallocationsApiInstance.getAllocation(allocation_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.allocations.getAllocation(allocationGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nallocations_api_instance = asana.AllocationsApi(api_client)\nallocation_gid = \"77688\" # str | Globally unique identifier for the allocation.\nopts = {\n    'opt_fields': \"assignee,assignee.name,created_by,created_by.name,effort,effort.type,effort.value,end_date,parent,parent.name,parent.resource_subtype,resource_subtype,start_date\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get an allocation\n    api_response = allocations_api_instance.get_allocation(allocation_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling AllocationsApi->get_allocation: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.allocations.get_allocation(allocation_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/allocation_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "put": {
        "description": "An existing allocation can be updated by making a PUT request on the URL for\nthat allocation. Only the fields provided in the `data` block will be updated;\nany unspecified fields will remain unchanged.\n\nReturns the complete updated allocation record.",
        "operationId": "updateAllocation",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "assignee",
              "assignee.name",
              "created_by",
              "created_by.name",
              "effort",
              "effort.type",
              "effort.value",
              "end_date",
              "parent",
              "parent.name",
              "parent.resource_subtype",
              "resource_subtype",
              "start_date"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "assignee",
                  "assignee.name",
                  "created_by",
                  "created_by.name",
                  "effort",
                  "effort.type",
                  "effort.value",
                  "end_date",
                  "parent",
                  "parent.name",
                  "parent.resource_subtype",
                  "resource_subtype",
                  "start_date"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/AllocationRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The updated fields for the allocation.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/AllocationResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__AllocationResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully updated the allocation."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Update an allocation",
        "tags": [
          "Allocations"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1allocations~1{allocation_gid}/put",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet allocationsApiInstance = new Asana.AllocationsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The updated fields for the allocation.\nlet allocation_gid = \"77688\"; // String | Globally unique identifier for the allocation.\nlet opts = { \n    'opt_fields': \"assignee,assignee.name,created_by,created_by.name,effort,effort.type,effort.value,end_date,parent,parent.name,parent.resource_subtype,resource_subtype,start_date\"\n};\nallocationsApiInstance.updateAllocation(body, allocation_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.allocations.updateAllocation(allocationGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nallocations_api_instance = asana.AllocationsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The updated fields for the allocation.\nallocation_gid = \"77688\" # str | Globally unique identifier for the allocation.\nopts = {\n    'opt_fields': \"assignee,assignee.name,created_by,created_by.name,effort,effort.type,effort.value,end_date,parent,parent.name,parent.resource_subtype,resource_subtype,start_date\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Update an allocation\n    api_response = allocations_api_instance.update_allocation(body, allocation_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling AllocationsApi->update_allocation: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.allocations.update_allocation(allocation_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            }
          ]
        }
      }
    },
    "/attachments": {
      "get": {
        "description": "<b>Required scope: </b><code>attachments:read</code>\n\nReturns the compact records for all attachments on the object.\nThere are three possible `parent` values for this request: `project`, `project_brief`, and `task`. For a project, an attachment refers to a file uploaded to the \"Key resources\" section in the project Overview. For a project brief, an attachment refers to inline files in the project brief itself. For a task, an attachment refers to a file directly associated to that task.\n\nNote that within the Asana app, inline images in the task description do not appear in the index of image thumbnails nor as stories in the task. However, requests made to `GET /attachments` for a task will return all of the images in the task, including inline images.",
        "operationId": "getAttachmentsForObject",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "Globally unique identifier for the object to fetch attachments from. Must be a GID for a `project`, `project_brief`, or `task`.",
            "example": "159874",
            "in": "query",
            "name": "parent",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "connected_to_app",
              "created_at",
              "download_url",
              "host",
              "name",
              "offset",
              "parent",
              "parent.created_by",
              "parent.name",
              "parent.resource_subtype",
              "path",
              "permanent_url",
              "resource_subtype",
              "size",
              "uri",
              "view_url"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "connected_to_app",
                  "created_at",
                  "download_url",
                  "host",
                  "name",
                  "offset",
                  "parent",
                  "parent.created_by",
                  "parent.name",
                  "parent.resource_subtype",
                  "path",
                  "permanent_url",
                  "resource_subtype",
                  "size",
                  "uri",
                  "view_url"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/AttachmentCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__AttachmentResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the specified object's attachments."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "attachments:read"
            ]
          }
        ],
        "summary": "Get attachments from an object",
        "tags": [
          "Attachments"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1attachments/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Attachment> result = client.attachments.getAttachmentsForObject(parent)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet attachmentsApiInstance = new Asana.AttachmentsApi(client);\nlet parent = \"159874\"; // String | Globally unique identifier for the object to fetch attachments from. Must be a GID for a `project`, `project_brief`, or `task`.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"connected_to_app,created_at,download_url,host,name,offset,parent,parent.created_by,parent.name,parent.resource_subtype,path,permanent_url,resource_subtype,size,uri,view_url\"\n};\nattachmentsApiInstance.getAttachmentsForObject(parent, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.attachments.getAttachmentsForObject({param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nattachments_api_instance = asana.AttachmentsApi(api_client)\nparent = \"159874\" # str | Globally unique identifier for the object to fetch attachments from. Must be a GID for a `project`, `project_brief`, or `task`.\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    'opt_fields': \"connected_to_app,created_at,download_url,host,name,offset,parent,parent.created_by,parent.name,parent.resource_subtype,path,permanent_url,resource_subtype,size,uri,view_url\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get attachments from an object\n    api_response = attachments_api_instance.get_attachments_for_object(parent, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling AttachmentsApi->get_attachments_for_object: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.attachments.get_attachments_for_object({'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->attachments->getAttachmentsForObject(array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.attachments.get_attachments_for_object(parent: '&#x27;parent_example&#x27;', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>attachments:write</code>\n\nUpload an attachment.\n\nThis method uploads an attachment on an object and returns the compact\nrecord for the created attachment object. This is possible by either:\n\n- Providing the URL of the external resource being attached, or\n- Downloading the file content first and then uploading it as any other attachment. Note that it is not possible to attach\nfiles from third party services such as Dropbox, Box, Vimeo & Google Drive via the API\n\nThe 100MB size limit on attachments in Asana is enforced on this endpoint.\n\nThis endpoint expects a multipart/form-data encoded request containing the full contents of the file to be uploaded.\n\nRequests made should follow the HTTP/1.1 specification that line\nterminators are of the form `CRLF` or `\\r\\n` outlined\n[here](http://www.w3.org/Protocols/HTTP/1.1/draft-ietf-http-v11-spec-01#Basic-Rules) in order for the server to reliably and properly handle the request.\n\nFor file names that contain non-ASCII characters, the file name should be URL-encoded. For example, a file named `résumé.pdf` should be encoded as\n`r%C3%A9sum%C3%A9.pdf` and the `filename` parameter in the `Content-Disposition` header should be set to the encoded file name.\n\nBelow is an example of a cURL request with the `Content-Disposition` header:\n\n```\nexport ASANA_PAT=\"<YOUR_ASANA_PERSONAL_ACCESS_TOKEN>\"\nexport PARENT_ID=\"<PARENT_GID>\"\nexport ENCODED_NAME=\"r%C3%A9sum%C3%A9.pdf\"\ncurl --location 'https://app.asana.com/api/1.0/attachments' \\\n  --header 'Content-Type: multipart/form-data' \\\n  --header 'Accept: application/json' \\\n  --header \"Authorization: Bearer $ASANA_PAT\" \\\n  --form \"parent=$PARENT_ID\" \\\n  --form \"file=@/Users/exampleUser/Downloads/résumé.pdf;headers=\\\"Content-Disposition: form-data; name=\"file\"; filename=\"$ENCODED_NAME.pdf\"; filename*=UTF-8''$ENCODED_NAME.pdf\\\"\"\n```",
        "operationId": "createAttachmentForObject",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "connected_to_app",
              "created_at",
              "download_url",
              "host",
              "name",
              "parent",
              "parent.created_by",
              "parent.name",
              "parent.resource_subtype",
              "permanent_url",
              "resource_subtype",
              "size",
              "view_url"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "connected_to_app",
                  "created_at",
                  "download_url",
                  "host",
                  "name",
                  "parent",
                  "parent.created_by",
                  "parent.name",
                  "parent.resource_subtype",
                  "permanent_url",
                  "resource_subtype",
                  "size",
                  "view_url"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/AttachmentRequest"
              }
            }
          },
          "description": "The file you want to upload.\n\n*Note when using curl:*\n\nBe sure to add an `‘@’` before the file path, and use the `--form`\noption instead of the `-d` option.\n\nWhen uploading PDFs with curl, force the content-type to be pdf by\nappending the content type to the file path: `--form\n\"file=@file.pdf;type=application/pdf\"`."
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/AttachmentResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__AttachmentResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully uploaded the attachment to the parent object."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "attachments:write"
            ]
          }
        ],
        "summary": "Upload an attachment",
        "tags": [
          "Attachments"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1attachments/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nAttachment result = client.attachments.createAttachmentForObject(file, parent, url, name)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\nconst fs = require(\"fs\");\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet attachmentsApiInstance = new Asana.AttachmentsApi(client);\nlet opts = { \n    'resource_subtype': \"external\", \n    'file': fs.createReadStream(\"file_example\"), \n    'parent': \"parent_example\", \n    'url': \"url_example\", \n    'name': \"name_example\", \n    'connect_to_app': true, \n    'opt_fields': \"connected_to_app,created_at,download_url,host,name,parent,parent.created_by,parent.name,parent.resource_subtype,permanent_url,resource_subtype,size,view_url\"\n};\nattachmentsApiInstance.createAttachmentForObject(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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.attachments.createAttachmentForObject({field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nattachments_api_instance = asana.AttachmentsApi(api_client)\nopts = {\n    'resource_subtype': \"external\", # str | \n    'file': \"file_example\", # str | \n    'parent': \"parent_example\", # str | \n    'url': \"url_example\", # str | \n    'name': \"name_example\", # str | \n    'connect_to_app': True, # bool | \n    'opt_fields': \"connected_to_app,created_at,download_url,host,name,parent,parent.created_by,parent.name,parent.resource_subtype,permanent_url,resource_subtype,size,view_url\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Upload an attachment\n    api_response = attachments_api_instance.create_attachment_for_object(opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling AttachmentsApi->create_attachment_for_object: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.attachments.create_attachment_for_object({'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->attachments->createAttachmentForObject(array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.attachments.create_attachment_for_object(field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/attachments/{attachment_gid}": {
      "delete": {
        "description": "<b>Required scope: </b><code>attachments:delete</code>\n\nDeletes a specific, existing attachment.\n\nReturns an empty data record.",
        "operationId": "deleteAttachment",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully deleted the specified attachment."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "attachments:delete"
            ]
          }
        ],
        "summary": "Delete an attachment",
        "tags": [
          "Attachments"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1attachments~1{attachment_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.attachments.deleteAttachment(attachmentGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet attachmentsApiInstance = new Asana.AttachmentsApi(client);\nlet attachment_gid = \"12345\"; // String | Globally unique identifier for the attachment.\n\nattachmentsApiInstance.deleteAttachment(attachment_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.attachments.deleteAttachment(attachmentGid)\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nattachments_api_instance = asana.AttachmentsApi(api_client)\nattachment_gid = \"12345\" # str | Globally unique identifier for the attachment.\n\n\ntry:\n    # Delete an attachment\n    api_response = attachments_api_instance.delete_attachment(attachment_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling AttachmentsApi->delete_attachment: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.attachments.delete_attachment(attachment_gid, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->attachments->deleteAttachment($attachment_gid, array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.attachments.delete_attachment(attachment_gid: 'attachment_gid', options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "get": {
        "description": "<b>Required scope: </b><code>attachments:read</code>\n\nGet the full record for a single attachment.",
        "operationId": "getAttachment",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "connected_to_app",
              "created_at",
              "download_url",
              "host",
              "name",
              "parent",
              "parent.created_by",
              "parent.name",
              "parent.resource_subtype",
              "permanent_url",
              "resource_subtype",
              "size",
              "view_url"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "connected_to_app",
                  "created_at",
                  "download_url",
                  "host",
                  "name",
                  "parent",
                  "parent.created_by",
                  "parent.name",
                  "parent.resource_subtype",
                  "permanent_url",
                  "resource_subtype",
                  "size",
                  "view_url"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/AttachmentResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__AttachmentResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the record for a single attachment."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "424": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          },
          "501": {
            "$ref": "#/components/responses/BadGateway"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          },
          "504": {
            "$ref": "#/components/responses/GatewayTimeout"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "attachments:read"
            ]
          }
        ],
        "summary": "Get an attachment",
        "tags": [
          "Attachments"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1attachments~1{attachment_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nAttachment result = client.attachments.getAttachment(attachmentGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet attachmentsApiInstance = new Asana.AttachmentsApi(client);\nlet attachment_gid = \"12345\"; // String | Globally unique identifier for the attachment.\nlet opts = { \n    'opt_fields': \"connected_to_app,created_at,download_url,host,name,parent,parent.created_by,parent.name,parent.resource_subtype,permanent_url,resource_subtype,size,view_url\"\n};\nattachmentsApiInstance.getAttachment(attachment_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.attachments.getAttachment(attachmentGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nattachments_api_instance = asana.AttachmentsApi(api_client)\nattachment_gid = \"12345\" # str | Globally unique identifier for the attachment.\nopts = {\n    'opt_fields': \"connected_to_app,created_at,download_url,host,name,parent,parent.created_by,parent.name,parent.resource_subtype,permanent_url,resource_subtype,size,view_url\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get an attachment\n    api_response = attachments_api_instance.get_attachment(attachment_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling AttachmentsApi->get_attachment: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.attachments.get_attachment(attachment_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->attachments->getAttachment($attachment_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.attachments.get_attachment(attachment_gid: 'attachment_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/attachment_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/batch": {
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/budgets": {
      "get": {
        "description": "Gets all budgets for a given *parent*. This will at most return a list of size 1 for a given *parent*.",
        "operationId": "getBudgets",
        "parameters": [
          {
            "description": "Globally unique identifier for the budget's parent object. This currently can only be a `project`.",
            "example": "1331",
            "in": "query",
            "name": "parent",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/BudgetResponse"
                          },
                          "type": "array"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__BudgetResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested budgets."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get all budgets",
        "tags": [
          "Budgets"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1budgets/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet budgetsApiInstance = new Asana.BudgetsApi(client);\nlet parent = \"1331\"; // String | Globally unique identifier for the budget's parent object. This currently can only be a `project`.\n\nbudgetsApiInstance.getBudgets(parent).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nbudgets_api_instance = asana.BudgetsApi(api_client)\nparent = \"1331\" # str | Globally unique identifier for the budget's parent object. This currently can only be a `project`.\n\n\ntry:\n    # Get all budgets\n    api_response = budgets_api_instance.get_budgets(parent)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling BudgetsApi->get_budgets: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "Creates a new budget.",
        "operationId": "createBudget",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/BudgetRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The budget to create.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/BudgetResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__BudgetResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created a new budget."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Create a budget",
        "tags": [
          "Budgets"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1budgets/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet budgetsApiInstance = new Asana.BudgetsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The budget to create.\n\nbudgetsApiInstance.createBudget(body).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nbudgets_api_instance = asana.BudgetsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The budget to create.\n\n\ntry:\n    # Create a budget\n    api_response = budgets_api_instance.create_budget(body)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling BudgetsApi->create_budget: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/budgets/{budget_gid}": {
      "delete": {
        "description": "A specific, existing budget can be deleted by making a DELETE request on the URL for that budget.\n\nReturns an empty data record.",
        "operationId": "deleteBudget",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully deleted the specified budget."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Delete a budget",
        "tags": [
          "Budgets"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1budgets~1{budget_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet budgetsApiInstance = new Asana.BudgetsApi(client);\nlet budget_gid = \"12345\"; // String | Globally unique identifier for the budget.\n\nbudgetsApiInstance.deleteBudget(budget_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nbudgets_api_instance = asana.BudgetsApi(api_client)\nbudget_gid = \"12345\" # str | Globally unique identifier for the budget.\n\n\ntry:\n    # Delete a budget\n    api_response = budgets_api_instance.delete_budget(budget_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling BudgetsApi->delete_budget: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "get": {
        "description": "Returns the complete budget record for a single budget.",
        "operationId": "getBudget",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "actual",
              "actual.billable_status_filter",
              "actual.units",
              "actual.value",
              "budget_type",
              "estimate",
              "estimate.billable_status_filter",
              "estimate.enabled",
              "estimate.source",
              "estimate.units",
              "estimate.value",
              "parent",
              "parent.name",
              "parent.resource_subtype",
              "total",
              "total.enabled",
              "total.units",
              "total.value"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "actual",
                  "actual.billable_status_filter",
                  "actual.units",
                  "actual.value",
                  "budget_type",
                  "estimate",
                  "estimate.billable_status_filter",
                  "estimate.enabled",
                  "estimate.source",
                  "estimate.units",
                  "estimate.value",
                  "parent",
                  "parent.name",
                  "parent.resource_subtype",
                  "total",
                  "total.enabled",
                  "total.units",
                  "total.value"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/BudgetResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__BudgetResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested budget."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get a budget",
        "tags": [
          "Budgets"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1budgets~1{budget_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet budgetsApiInstance = new Asana.BudgetsApi(client);\nlet budget_gid = \"12345\"; // String | Globally unique identifier for the budget.\nlet opts = { \n    'opt_fields': \"actual,actual.billable_status_filter,actual.units,actual.value,budget_type,estimate,estimate.billable_status_filter,estimate.enabled,estimate.source,estimate.units,estimate.value,parent,parent.name,parent.resource_subtype,total,total.enabled,total.units,total.value\"\n};\nbudgetsApiInstance.getBudget(budget_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nbudgets_api_instance = asana.BudgetsApi(api_client)\nbudget_gid = \"12345\" # str | Globally unique identifier for the budget.\nopts = {\n    'opt_fields': \"actual,actual.billable_status_filter,actual.units,actual.value,budget_type,estimate,estimate.billable_status_filter,estimate.enabled,estimate.source,estimate.units,estimate.value,parent,parent.name,parent.resource_subtype,total,total.enabled,total.units,total.value\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a budget\n    api_response = budgets_api_instance.get_budget(budget_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling BudgetsApi->get_budget: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/budget_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "put": {
        "description": "An existing budget can be updated by making a PUT request on the URL for\nthat budget. Only the fields provided in the `data` block will be updated;\nany unspecified fields will remain unchanged.",
        "operationId": "updateBudget",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "actual",
              "actual.billable_status_filter",
              "actual.units",
              "actual.value",
              "budget_type",
              "estimate",
              "estimate.billable_status_filter",
              "estimate.enabled",
              "estimate.source",
              "estimate.units",
              "estimate.value",
              "parent",
              "parent.name",
              "parent.resource_subtype",
              "total",
              "total.enabled",
              "total.units",
              "total.value"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "actual",
                  "actual.billable_status_filter",
                  "actual.units",
                  "actual.value",
                  "budget_type",
                  "estimate",
                  "estimate.billable_status_filter",
                  "estimate.enabled",
                  "estimate.source",
                  "estimate.units",
                  "estimate.value",
                  "parent",
                  "parent.name",
                  "parent.resource_subtype",
                  "total",
                  "total.enabled",
                  "total.units",
                  "total.value"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/BudgetRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The budget to update.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/BudgetResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__BudgetResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully updated the budget."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Update a budget",
        "tags": [
          "Budgets"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1budgets~1{budget_gid}/put",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet budgetsApiInstance = new Asana.BudgetsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The budget to update.\nlet budget_gid = \"12345\"; // String | Globally unique identifier for the budget.\nlet opts = { \n    'opt_fields': \"actual,actual.billable_status_filter,actual.units,actual.value,budget_type,estimate,estimate.billable_status_filter,estimate.enabled,estimate.source,estimate.units,estimate.value,parent,parent.name,parent.resource_subtype,total,total.enabled,total.units,total.value\"\n};\nbudgetsApiInstance.updateBudget(body, budget_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nbudgets_api_instance = asana.BudgetsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The budget to update.\nbudget_gid = \"12345\" # str | Globally unique identifier for the budget.\nopts = {\n    'opt_fields': \"actual,actual.billable_status_filter,actual.units,actual.value,budget_type,estimate,estimate.billable_status_filter,estimate.enabled,estimate.source,estimate.units,estimate.value,parent,parent.name,parent.resource_subtype,total,total.enabled,total.units,total.value\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Update a budget\n    api_response = budgets_api_instance.update_budget(body, budget_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling BudgetsApi->update_budget: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/custom_fields": {
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/custom_fields/{custom_field_gid}": {
      "delete": {
        "description": "A specific, existing custom field can be deleted by making a DELETE request on the URL for that custom field.\nLocked custom fields can only be deleted by the user who locked the field.\nReturns an empty data record.",
        "operationId": "deleteCustomField",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "The custom field was successfully deleted."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Delete a custom field",
        "tags": [
          "Custom fields"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1custom_fields~1{custom_field_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.customfields.deleteCustomField(customFieldGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet customFieldsApiInstance = new Asana.CustomFieldsApi(client);\nlet custom_field_gid = \"12345\"; // String | Globally unique identifier for the custom field.\n\ncustomFieldsApiInstance.deleteCustomField(custom_field_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.customfields.deleteCustomField(customFieldGid)\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ncustom_fields_api_instance = asana.CustomFieldsApi(api_client)\ncustom_field_gid = \"12345\" # str | Globally unique identifier for the custom field.\n\n\ntry:\n    # Delete a custom field\n    api_response = custom_fields_api_instance.delete_custom_field(custom_field_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling CustomFieldsApi->delete_custom_field: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.custom_fields.delete_custom_field(custom_field_gid, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->customfields->deleteCustomField($custom_field_gid, array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.custom_fields.delete_custom_field(custom_field_gid: 'custom_field_gid', options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "get": {
        "description": "<b>Required scope: </b><code>custom_fields:read</code>\n\nGet the complete definition of a custom field’s metadata.\n\nSince custom fields can be defined for one of a number of types, and\nthese types have different data and behaviors, there are fields that are\nrelevant to a particular type. For instance, as noted above, enum_options\nis only relevant for the enum type and defines the set of choices that\nthe enum could represent. The examples below show some of these\ntype-specific custom field definitions.",
        "operationId": "getCustomField",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "asana_created_field",
              "created_by",
              "created_by.name",
              "currency_code",
              "custom_label",
              "custom_label_position",
              "date_value",
              "date_value.date",
              "date_value.date_time",
              "default_access_level",
              "description",
              "display_value",
              "enabled",
              "enum_options",
              "enum_options.color",
              "enum_options.enabled",
              "enum_options.name",
              "enum_value",
              "enum_value.color",
              "enum_value.enabled",
              "enum_value.name",
              "format",
              "has_notifications_enabled",
              "html_text_value",
              "id_prefix",
              "input_restrictions",
              "is_formula_field",
              "is_global_to_workspace",
              "is_lookup_field",
              "is_value_read_only",
              "multi_enum_values",
              "multi_enum_values.color",
              "multi_enum_values.enabled",
              "multi_enum_values.name",
              "name",
              "number_value",
              "people_value",
              "people_value.name",
              "precision",
              "privacy_setting",
              "reference_value",
              "reference_value.name",
              "representation_type",
              "resource_subtype",
              "text_value",
              "type"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "asana_created_field",
                  "created_by",
                  "created_by.name",
                  "currency_code",
                  "custom_label",
                  "custom_label_position",
                  "date_value",
                  "date_value.date",
                  "date_value.date_time",
                  "default_access_level",
                  "description",
                  "display_value",
                  "enabled",
                  "enum_options",
                  "enum_options.color",
                  "enum_options.enabled",
                  "enum_options.name",
                  "enum_value",
                  "enum_value.color",
                  "enum_value.enabled",
                  "enum_value.name",
                  "format",
                  "has_notifications_enabled",
                  "html_text_value",
                  "id_prefix",
                  "input_restrictions",
                  "is_formula_field",
                  "is_global_to_workspace",
                  "is_lookup_field",
                  "is_value_read_only",
                  "multi_enum_values",
                  "multi_enum_values.color",
                  "multi_enum_values.enabled",
                  "multi_enum_values.name",
                  "name",
                  "number_value",
                  "people_value",
                  "people_value.name",
                  "precision",
                  "privacy_setting",
                  "reference_value",
                  "reference_value.name",
                  "representation_type",
                  "resource_subtype",
                  "text_value",
                  "type"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/CustomFieldResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__CustomFieldResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the complete definition of a custom field’s metadata."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "custom_fields:read"
            ]
          }
        ],
        "summary": "Get a custom field",
        "tags": [
          "Custom fields"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1custom_fields~1{custom_field_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nCustomField result = client.customfields.getCustomField(customFieldGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet customFieldsApiInstance = new Asana.CustomFieldsApi(client);\nlet custom_field_gid = \"12345\"; // String | Globally unique identifier for the custom field.\nlet opts = { \n    'opt_fields': \"asana_created_field,created_by,created_by.name,currency_code,custom_label,custom_label_position,date_value,date_value.date,date_value.date_time,default_access_level,description,display_value,enabled,enum_options,enum_options.color,enum_options.enabled,enum_options.name,enum_value,enum_value.color,enum_value.enabled,enum_value.name,format,has_notifications_enabled,html_text_value,id_prefix,input_restrictions,is_formula_field,is_global_to_workspace,is_lookup_field,is_value_read_only,multi_enum_values,multi_enum_values.color,multi_enum_values.enabled,multi_enum_values.name,name,number_value,people_value,people_value.name,precision,privacy_setting,reference_value,reference_value.name,representation_type,resource_subtype,text_value,type\"\n};\ncustomFieldsApiInstance.getCustomField(custom_field_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.customfields.getCustomField(customFieldGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ncustom_fields_api_instance = asana.CustomFieldsApi(api_client)\ncustom_field_gid = \"12345\" # str | Globally unique identifier for the custom field.\nopts = {\n    'opt_fields': \"asana_created_field,created_by,created_by.name,currency_code,custom_label,custom_label_position,date_value,date_value.date,date_value.date_time,default_access_level,description,display_value,enabled,enum_options,enum_options.color,enum_options.enabled,enum_options.name,enum_value,enum_value.color,enum_value.enabled,enum_value.name,format,has_notifications_enabled,html_text_value,id_prefix,input_restrictions,is_formula_field,is_global_to_workspace,is_lookup_field,is_value_read_only,multi_enum_values,multi_enum_values.color,multi_enum_values.enabled,multi_enum_values.name,name,number_value,people_value,people_value.name,precision,privacy_setting,reference_value,reference_value.name,representation_type,resource_subtype,text_value,type\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a custom field\n    api_response = custom_fields_api_instance.get_custom_field(custom_field_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling CustomFieldsApi->get_custom_field: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.custom_fields.get_custom_field(custom_field_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->customfields->getCustomField($custom_field_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.custom_fields.get_custom_field(custom_field_gid: 'custom_field_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/custom_field_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/custom_fields/{custom_field_gid}/enum_options": {
      "parameters": [
        {
          "$ref": "#/components/parameters/custom_field_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>custom_fields:write</code>\n\nCreates an enum option and adds it to this custom field’s list of enum options. A custom field can have at most 500 enum options (including disabled options). By default new enum options are inserted at the end of a custom field’s list.\nLocked custom fields can only have enum options added by the user who locked the field.\nReturns the full record of the newly created enum option.",
        "operationId": "createEnumOptionForCustomField",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "color",
              "enabled",
              "name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "color",
                  "enabled",
                  "name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnumOptionRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The enum option object to create."
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EnumOption"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EnumOptionData"
                    }
                  ]
                }
              }
            },
            "description": "Custom field enum option successfully created."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "custom_fields:write"
            ]
          }
        ],
        "summary": "Create an enum option",
        "tags": [
          "Custom fields"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1custom_fields~1{custom_field_gid}~1enum_options/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.customfields.createEnumOptionForCustomField(customFieldGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet customFieldsApiInstance = new Asana.CustomFieldsApi(client);\nlet custom_field_gid = \"12345\"; // String | Globally unique identifier for the custom field.\nlet opts = { \n    'body': {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}, \n    'opt_fields': \"color,enabled,name\"\n};\ncustomFieldsApiInstance.createEnumOptionForCustomField(custom_field_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.customfields.createEnumOptionForCustomField(customFieldGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ncustom_fields_api_instance = asana.CustomFieldsApi(api_client)\ncustom_field_gid = \"12345\" # str | Globally unique identifier for the custom field.\nopts = {\n    'body': {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}, # dict | The enum option object to create.\n    'opt_fields': \"color,enabled,name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create an enum option\n    api_response = custom_fields_api_instance.create_enum_option_for_custom_field(custom_field_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling CustomFieldsApi->create_enum_option_for_custom_field: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.custom_fields.create_enum_option_for_custom_field(custom_field_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->customfields->createEnumOptionForCustomField($custom_field_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.custom_fields.create_enum_option_for_custom_field(custom_field_gid: 'custom_field_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/custom_fields/{custom_field_gid}/enum_options/insert": {
      "parameters": [
        {
          "$ref": "#/components/parameters/custom_field_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>custom_fields:write</code>\n\nMoves a particular enum option to be either before or after another specified enum option in the custom field.\nLocked custom fields can only be reordered by the user who locked the field.",
        "operationId": "insertEnumOptionForCustomField",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "color",
              "enabled",
              "name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "color",
                  "enabled",
                  "name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnumOptionInsertRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The enum option object to create."
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EnumOption"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EnumOptionData"
                    }
                  ]
                }
              }
            },
            "description": "Custom field enum option successfully reordered."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "custom_fields:write"
            ]
          }
        ],
        "summary": "Reorder a custom field's enum",
        "tags": [
          "Custom fields"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1custom_fields~1{custom_field_gid}~1enum_options~1insert/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.customfields.insertEnumOptionForCustomField(customFieldGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet customFieldsApiInstance = new Asana.CustomFieldsApi(client);\nlet custom_field_gid = \"12345\"; // String | Globally unique identifier for the custom field.\nlet opts = { \n    'body': {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}, \n    'opt_fields': \"color,enabled,name\"\n};\ncustomFieldsApiInstance.insertEnumOptionForCustomField(custom_field_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.customfields.insertEnumOptionForCustomField(customFieldGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ncustom_fields_api_instance = asana.CustomFieldsApi(api_client)\ncustom_field_gid = \"12345\" # str | Globally unique identifier for the custom field.\nopts = {\n    'body': {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}, # dict | The enum option object to create.\n    'opt_fields': \"color,enabled,name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Reorder a custom field's enum\n    api_response = custom_fields_api_instance.insert_enum_option_for_custom_field(custom_field_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling CustomFieldsApi->insert_enum_option_for_custom_field: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.custom_fields.insert_enum_option_for_custom_field(custom_field_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->customfields->insertEnumOptionForCustomField($custom_field_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.custom_fields.insert_enum_option_for_custom_field(custom_field_gid: 'custom_field_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/custom_types": {
      "get": {
        "description": "<b>Required scope: </b><code>custom_types:read</code>\n\nReturns a list of all of the custom types associated with an object. Exactly one of `project` or `workspace` must be provided as a query parameter. When `workspace` is provided, all custom types in the workspace are listed, including types created by Asana products. Note that, as in all queries to collections which return compact representation, `opt_fields` can be used to include more data than is returned in the compact representation. See the [documentation for input/output options](https://developers.asana.com/docs/inputoutput-options) for more information.",
        "operationId": "getCustomTypes",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "asana_created_type_identifier",
              "name",
              "offset",
              "path",
              "status_options",
              "status_options.color",
              "status_options.completion_state",
              "status_options.enabled",
              "status_options.name",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "asana_created_type_identifier",
                  "name",
                  "offset",
                  "path",
                  "status_options",
                  "status_options.color",
                  "status_options.completion_state",
                  "status_options.enabled",
                  "status_options.name",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/CustomTypeResponse"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__CustomTypeResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved custom types"
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "custom_types:read"
            ]
          }
        ],
        "summary": "Get all custom types associated with an object",
        "tags": [
          "Custom types"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1custom_types/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet customTypesApiInstance = new Asana.CustomTypesApi(client);\nlet opts = { \n    'project': \"1331\", \n    'workspace': \"12345\", \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"asana_created_type_identifier,name,offset,path,status_options,status_options.color,status_options.completion_state,status_options.enabled,status_options.name,uri\"\n};\ncustomTypesApiInstance.getCustomTypes(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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ncustom_types_api_instance = asana.CustomTypesApi(api_client)\nopts = {\n    'project': \"1331\", # str | Globally unique identifier for the project, used as a filter when retrieving custom types.\n    'workspace': \"12345\", # str | The workspace to filter results on.\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    'opt_fields': \"asana_created_type_identifier,name,offset,path,status_options,status_options.color,status_options.completion_state,status_options.enabled,status_options.name,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get all custom types associated with an object\n    api_response = custom_types_api_instance.get_custom_types(opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling CustomTypesApi->get_custom_types: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/project_query_param"
        },
        {
          "$ref": "#/components/parameters/workspace_query_param"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/custom_types/{custom_type_gid}": {
      "get": {
        "description": "<b>Required scope: </b><code>custom_types:read</code>\n\nReturns the complete custom type record for a single custom type.",
        "operationId": "getCustomType",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "asana_created_type_identifier",
              "name",
              "status_options",
              "status_options.color",
              "status_options.completion_state",
              "status_options.enabled",
              "status_options.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "asana_created_type_identifier",
                  "name",
                  "status_options",
                  "status_options.color",
                  "status_options.completion_state",
                  "status_options.enabled",
                  "status_options.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/CustomTypeResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__CustomTypeResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested custom type."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "custom_types:read"
            ]
          }
        ],
        "summary": "Get a custom type",
        "tags": [
          "Custom types"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1custom_types~1{custom_type_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet customTypesApiInstance = new Asana.CustomTypesApi(client);\nlet custom_type_gid = \"12345\"; // String | Globally unique identifier for the custom type.\nlet opts = { \n    'opt_fields': \"asana_created_type_identifier,name,status_options,status_options.color,status_options.completion_state,status_options.enabled,status_options.name\"\n};\ncustomTypesApiInstance.getCustomType(custom_type_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ncustom_types_api_instance = asana.CustomTypesApi(api_client)\ncustom_type_gid = \"12345\" # str | Globally unique identifier for the custom type.\nopts = {\n    'opt_fields': \"asana_created_type_identifier,name,status_options,status_options.color,status_options.completion_state,status_options.enabled,status_options.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a custom type\n    api_response = custom_types_api_instance.get_custom_type(custom_type_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling CustomTypesApi->get_custom_type: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/custom_type_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/enum_options/{enum_option_gid}": {
      "parameters": [
        {
          "description": "Globally unique identifier for the enum option.",
          "example": "124578",
          "in": "path",
          "name": "enum_option_gid",
          "required": true,
          "schema": {
            "type": "string"
          }
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "put": {
        "description": "<b>Required scope: </b><code>custom_fields:write</code>\n\nUpdates an existing enum option. Enum custom fields require at least one enabled enum option.\nLocked custom fields can only be updated by the user who locked the field.\nReturns the full record of the updated enum option.",
        "operationId": "updateEnumOption",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "color",
              "enabled",
              "name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "color",
                  "enabled",
                  "name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnumOptionBase"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The enum option object to update"
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EnumOption"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EnumOptionData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully updated the specified custom field enum."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "custom_fields:write"
            ]
          }
        ],
        "summary": "Update an enum option",
        "tags": [
          "Custom fields"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1enum_options~1{enum_option_gid}/put",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.customfields.updateEnumOption(enumOptionGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet customFieldsApiInstance = new Asana.CustomFieldsApi(client);\nlet enum_option_gid = \"124578\"; // String | Globally unique identifier for the enum option.\nlet opts = { \n    'body': {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}, \n    'opt_fields': \"color,enabled,name\"\n};\ncustomFieldsApiInstance.updateEnumOption(enum_option_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.customfields.updateEnumOption(enumOptionGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ncustom_fields_api_instance = asana.CustomFieldsApi(api_client)\nenum_option_gid = \"124578\" # str | Globally unique identifier for the enum option.\nopts = {\n    'body': {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}, # dict | The enum option object to update\n    'opt_fields': \"color,enabled,name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Update an enum option\n    api_response = custom_fields_api_instance.update_enum_option(enum_option_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling CustomFieldsApi->update_enum_option: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.custom_fields.update_enum_option(enum_option_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->customfields->updateEnumOption($enum_option_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.custom_fields.update_enum_option(enum_option_gid: 'enum_option_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/events": {
      "get": {
        "description": "Returns the full record for all events that have occurred since the sync\ntoken was created.\n\nA `GET` request to the endpoint `/[path_to_resource]/events` can be made in\nlieu of including the resource ID in the data for the request.\n\nAsana limits a single sync token to 100 events. If more than 100 events exist\nfor a given resource, `has_more: true` will be returned in the response, indicating\nthat there are more events to pull.\n\n*Note: The resource returned will be the resource that triggered the\nevent. This may be different from the one that the events were requested\nfor. For example, a subscription to a project will contain events for\ntasks contained within the project.*",
        "operationId": "getEvents",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "action",
              "change",
              "change.action",
              "change.added_value",
              "change.field",
              "change.new_value",
              "change.removed_value",
              "created_at",
              "parent",
              "parent.name",
              "resource",
              "resource.name",
              "type",
              "user",
              "user.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "action",
                  "change",
                  "change.action",
                  "change.added_value",
                  "change.field",
                  "change.new_value",
                  "change.removed_value",
                  "created_at",
                  "parent",
                  "parent.name",
                  "resource",
                  "resource.name",
                  "type",
                  "user",
                  "user.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "description": "The full record for all events that have occurred since the sync token was created.",
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/EventResponse"
                          },
                          "type": "array"
                        },
                        "has_more": {
                          "description": "Indicates whether there are more events to pull.",
                          "example": true,
                          "type": "boolean"
                        },
                        "sync": {
                          "description": "A sync token to be used with the next call to the /events endpoint.",
                          "example": "de4774f6915eae04714ca93bb2f5ee81",
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EventResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved events."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "412": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "message": {
                            "description": "Message providing more detail about the error that occurred, if available.",
                            "example": "Sync token invalid or too old. If you are attempting to keep resources in sync, you must fetch the full dataset for this query now and use the new sync token for the next sync.",
                            "readOnly": true,
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "sync": {
                      "description": "A sync token to be used with the next call to the /events endpoint.",
                      "example": "de4774f6915eae04714ca93bb2f5ee81",
                      "readOnly": true,
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "The request is missing or has an expired sync token."
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get events on a resource",
        "tags": [
          "Events"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1events/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<JsonElement> result = client.events.getEvents(sync, resource)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet eventsApiInstance = new Asana.EventsApi(client);\nlet resource = \"12345\"; // String | A resource ID to subscribe to. The resource can be a task, project, or goal.\nlet opts = { \n    'sync': \"de4774f6915eae04714ca93bb2f5ee81\", \n    'opt_fields': \"action,change,change.action,change.added_value,change.field,change.new_value,change.removed_value,created_at,parent,parent.name,resource,resource.name,type,user,user.name\"\n};\neventsApiInstance.getEvents(resource, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.events.getEvents({param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nevents_api_instance = asana.EventsApi(api_client)\nresource = \"12345\" # str | A resource ID to subscribe to. The resource can be a task, project, or goal.\nopts = {\n    'sync': \"de4774f6915eae04714ca93bb2f5ee81\", # str | A sync token received from the last request, or none on first sync. Events will be returned from the point in time that the sync token was generated. *Note: On your first request, omit the sync token. The response will be the same as for an expired sync token, and will include a new valid sync token.If the sync token is too old (which may happen from time to time) the API will return a `412 Precondition Failed` error, and include a fresh sync token in the response.*\n    'opt_fields': \"action,change,change.action,change.added_value,change.field,change.new_value,change.removed_value,created_at,parent,parent.name,resource,resource.name,type,user,user.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get events on a resource\n    api_response = events_api_instance.get_events(resource, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling EventsApi->get_events: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.events.get_events({'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->events->getEvents(array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.events.get_events(resource: '&#x27;resource_example&#x27;', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "description": "A resource ID to subscribe to. The resource can be a task, project, or goal.",
          "example": "12345",
          "in": "query",
          "name": "resource",
          "required": true,
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "A sync token received from the last request, or none on first sync. Events will be returned from the point in time that the sync token was generated.\n*Note: On your first request, omit the sync token. The response will be the same as for an expired sync token, and will include a new valid sync token.If the sync token is too old (which may happen from time to time) the API will return a `412 Precondition Failed` error, and include a fresh sync token in the response.*",
          "example": "de4774f6915eae04714ca93bb2f5ee81",
          "in": "query",
          "name": "sync",
          "required": false,
          "schema": {
            "type": "string"
          }
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/exports/graph": {
      "post": {
        "description": "Initiates a graph export job for a given parent object\n(goal, team, portfolio, or project). The export will be processed asynchronously.\nOnce initiated, use the [jobs](/reference/getjob) endpoint to monitor progress.\n\n**Export Caching:** When exporting more than 1,000 tasks, the results are cached for 4 hours. Any new export requests made within this 4-hour window will return the same cached results rather than generating a fresh export.",
        "operationId": "createGraphExport",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/GraphExportRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "A JSON payload specifying the parent object to export.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/GraphExportResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__GraphExportResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created Graph export request."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Initiate a graph export",
        "tags": [
          "Exports"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1exports~1graph/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet exportsApiInstance = new Asana.ExportsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | A JSON payload specifying the parent object to export.\n\nexportsApiInstance.createGraphExport(body).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nexports_api_instance = asana.ExportsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | A JSON payload specifying the parent object to export.\n\n\ntry:\n    # Initiate a graph export\n    api_response = exports_api_instance.create_graph_export(body)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling ExportsApi->create_graph_export: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/exports/resource": {
      "post": {
        "description": "Initiates a bulk export of resources for a workspace. The export will be processed asynchronously. Once the export has been requested, its progress can be monitored using the [jobs](/reference/getjob) endpoint.\n\n## Supported resource types\nThis endpoint currently supports exporting tasks, teams and messages within a workspace. Resources can be requested to be part of the export by providing the `export_request_parameters` parameter. The following resource types are supported:\n\n### Tasks:\nTasks are formatted for exports with some differences from their documented [schema](/reference/tasks):\n  - `attachments` are included by default and returns an array of associated attachments.\n  - Attachment objects do not include `download_url` or `view_url`. The `attachments` [endpoint](/reference/attachment) should be queried for up-to-date URLs.\n  - `stories` are included by default and returns an array of comments and other changes made to a task\n\n### Teams:\nTeams are formatted for exports with these differences from their documented [schema](/reference/teams):\n  - `members` are included by default and returns an array of Users that are members of the team\n  - Filtering is not supported for teams.\n\n### Messages:\nThe returned schema encompasses both default messages and status updates and is similar to the status update schema.\nThe available fields for messages are:\n  - `gid` - The globally unique identifier for the message.\n  - `resource_type` - The type of resource, which is always \"message\".\n  - `resource_subtype` - Optional. The subtype of the message, which can be \"default\" or \"status_update\".\n  - `status_type` - The type associated with the status update. This can be one of: “on_track”, “at_risk”, “off_track”, “on_hold”, “complete”, “achieved”, “partial”, “missed”, “dropped”\n  - `created_by` - The user who created the message.\n  - `created_at` - The time at which this resource was created and sent available to other users.\n  - `modified_at` - The time at which this resource was last modified.\n  - `title` - The title of the message.\n  - `text` - The text content of the message.\n  - `html_notes` - The text content of the message with formatting as HTML. Not included by default. Can be included by using “fields” in the initial request.\n  - `num_likes` - The number of users who have liked this message.\n  - `likes` - An array of users who have liked this message.\n  - `stories` - Optional. Array of stories applied to the message.\n  - `attachments` - Optional. Array of attachments added to the message.\n  - `followers` - Optional. Array of users currently following the message. Users that were sent the message are treated as followers.\n  - `parents` - Array of objects the message was sent to. Can be a Project, Portfolio, Team or Goal. Limited to a single object for status updates.\n\n\n## Export file\nThe final export file will be in JSON Lines format and compressed in a gzip container.\n\nObjects are formatted according to their corresponding API schema, or limited to the fields\nincluded in the `fields` parameter. Exports currently include undeleted objects.\n\nAn object in the export will be up to date anywhere between the exports `created_at` and `completed_at`. There is no guaranteed ordering of objects in the export.\n\nAccess to the export file expires 30 days after its completion.\n\n## Exporting specific fields\nBy default, each object in an export includes a predefined set of fields based on its schema. If a more limited set of fields\nor fields not included by default are required, the Export API allows for specifying which fields to include in the requested export.\n\nFields can be specified using the `fields` parameter. The fields parameter conforms to the fields\noptional parameter available for all Asana endpoints which is documented [here](https://developers.asana.com/docs/inputoutput-options).\n\nUtilizing the `fields` parameter is recommended if the full object is not required, especially when a large number of objects are being exported, to reduce the overall export time.\n\n## Filtering resources\nA disjunction of two or more filters can be achieved by providing multiple `export_request_parameters` for the same resource, each with different filters.\nHowever, this approach may result in duplicate resources being returned.\n\n## Rate Limits\nA workspace is currently limited to *one* in progress export request at a given time. The request will return with a 403 Forbidden status code if the limit is exceeded.",
        "operationId": "createResourceExport",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/ResourceExportRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "A JSON payload specifying the resources to export, including filters to apply and fields to be exported.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/ResourceExportResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ResourceExportResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created a Resource export request."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Initiate a resource export",
        "tags": [
          "Exports"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1exports~1resource/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet exportsApiInstance = new Asana.ExportsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | A JSON payload specifying the resources to export, including filters to apply and fields to be exported.\n\nexportsApiInstance.createResourceExport(body).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nexports_api_instance = asana.ExportsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | A JSON payload specifying the resources to export, including filters to apply and fields to be exported.\n\n\ntry:\n    # Initiate a resource export\n    api_response = exports_api_instance.create_resource_export(body)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling ExportsApi->create_resource_export: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/goal_relationships": {
      "get": {
        "description": "Returns compact goal relationship records.",
        "operationId": "getGoalRelationships",
        "parameters": [
          {
            "$ref": "#/components/parameters/pretty"
          },
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "Globally unique identifier for the supported goal in the goal relationship.",
            "example": "12345",
            "in": "query",
            "name": "supported_goal",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "If provided, filter to goal relationships with a given resource_subtype.",
            "example": "subgoal",
            "in": "query",
            "name": "resource_subtype",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "contribution_weight",
              "offset",
              "path",
              "resource_subtype",
              "supported_goal",
              "supported_goal.name",
              "supported_goal.owner",
              "supported_goal.owner.name",
              "supporting_resource",
              "supporting_resource.name",
              "supporting_resource.resource_subtype",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "contribution_weight",
                  "offset",
                  "path",
                  "resource_subtype",
                  "supported_goal",
                  "supported_goal.name",
                  "supported_goal.owner",
                  "supported_goal.owner.name",
                  "supporting_resource",
                  "supporting_resource.name",
                  "supporting_resource.resource_subtype",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/GoalRelationshipCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__GoalRelationshipResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested goal relationships."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get goal relationships",
        "tags": [
          "Goal relationships"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1goal_relationships/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<JsonElement> result = client.goalrelationships.getGoalRelationships(resourceSubtype, supportedGoal)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet goalRelationshipsApiInstance = new Asana.GoalRelationshipsApi(client);\nlet supported_goal = \"12345\"; // String | Globally unique identifier for the supported goal in the goal relationship.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'resource_subtype': \"subgoal\", \n    'opt_fields': \"contribution_weight,offset,path,resource_subtype,supported_goal,supported_goal.name,supported_goal.owner,supported_goal.owner.name,supporting_resource,supporting_resource.name,supporting_resource.resource_subtype,uri\"\n};\ngoalRelationshipsApiInstance.getGoalRelationships(supported_goal, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.goalrelationships.getGoalRelationships({param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ngoal_relationships_api_instance = asana.GoalRelationshipsApi(api_client)\nsupported_goal = \"12345\" # str | Globally unique identifier for the supported goal in the goal relationship.\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    'resource_subtype': \"subgoal\", # str | If provided, filter to goal relationships with a given resource_subtype.\n    'opt_fields': \"contribution_weight,offset,path,resource_subtype,supported_goal,supported_goal.name,supported_goal.owner,supported_goal.owner.name,supporting_resource,supporting_resource.name,supporting_resource.resource_subtype,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get goal relationships\n    api_response = goal_relationships_api_instance.get_goal_relationships(supported_goal, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling GoalRelationshipsApi->get_goal_relationships: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.goal_relationships.get_goal_relationships({'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->goalrelationships->getGoalRelationships(array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.goal_relationships.get_goal_relationships(supported_goal: '&#x27;supported_goal_example&#x27;', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/goal_relationships/{goal_relationship_gid}": {
      "get": {
        "description": "Returns the complete updated goal relationship record for a single goal relationship.",
        "operationId": "getGoalRelationship",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "contribution_weight",
              "resource_subtype",
              "supported_goal",
              "supported_goal.name",
              "supported_goal.owner",
              "supported_goal.owner.name",
              "supporting_resource",
              "supporting_resource.name",
              "supporting_resource.resource_subtype"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "contribution_weight",
                  "resource_subtype",
                  "supported_goal",
                  "supported_goal.name",
                  "supported_goal.owner",
                  "supported_goal.owner.name",
                  "supporting_resource",
                  "supporting_resource.name",
                  "supporting_resource.resource_subtype"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/GoalRelationshipResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__GoalRelationshipResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the record for the goal relationship."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get a goal relationship",
        "tags": [
          "Goal relationships"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1goal_relationships~1{goal_relationship_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.goalrelationships.getGoalRelationship(goalRelationshipGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet goalRelationshipsApiInstance = new Asana.GoalRelationshipsApi(client);\nlet goal_relationship_gid = \"12345\"; // String | Globally unique identifier for the goal relationship.\nlet opts = { \n    'opt_fields': \"contribution_weight,resource_subtype,supported_goal,supported_goal.name,supported_goal.owner,supported_goal.owner.name,supporting_resource,supporting_resource.name,supporting_resource.resource_subtype\"\n};\ngoalRelationshipsApiInstance.getGoalRelationship(goal_relationship_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.goalrelationships.getGoalRelationship(goalRelationshipGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ngoal_relationships_api_instance = asana.GoalRelationshipsApi(api_client)\ngoal_relationship_gid = \"12345\" # str | Globally unique identifier for the goal relationship.\nopts = {\n    'opt_fields': \"contribution_weight,resource_subtype,supported_goal,supported_goal.name,supported_goal.owner,supported_goal.owner.name,supporting_resource,supporting_resource.name,supporting_resource.resource_subtype\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a goal relationship\n    api_response = goal_relationships_api_instance.get_goal_relationship(goal_relationship_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling GoalRelationshipsApi->get_goal_relationship: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.goal_relationships.get_goal_relationship(goal_relationship_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->goalrelationships->getGoalRelationship($goal_relationship_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.goal_relationships.get_goal_relationship(goal_relationship_gid: 'goal_relationship_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/goal_relationship_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "put": {
        "description": "An existing goal relationship can be updated by making a PUT request on the URL for\nthat goal relationship. Only the fields provided in the `data` block will be updated;\nany unspecified fields will remain unchanged.\n\nReturns the complete updated goal relationship record.",
        "operationId": "updateGoalRelationship",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "contribution_weight",
              "resource_subtype",
              "supported_goal",
              "supported_goal.name",
              "supported_goal.owner",
              "supported_goal.owner.name",
              "supporting_resource",
              "supporting_resource.name",
              "supporting_resource.resource_subtype"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "contribution_weight",
                  "resource_subtype",
                  "supported_goal",
                  "supported_goal.name",
                  "supported_goal.owner",
                  "supported_goal.owner.name",
                  "supporting_resource",
                  "supporting_resource.name",
                  "supporting_resource.resource_subtype"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/GoalRelationshipRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The updated fields for the goal relationship.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/GoalRelationshipResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__GoalRelationshipResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully updated the goal relationship."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Update a goal relationship",
        "tags": [
          "Goal relationships"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1goal_relationships~1{goal_relationship_gid}/put",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.goalrelationships.updateGoalRelationship(goalRelationshipGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet goalRelationshipsApiInstance = new Asana.GoalRelationshipsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The updated fields for the goal relationship.\nlet goal_relationship_gid = \"12345\"; // String | Globally unique identifier for the goal relationship.\nlet opts = { \n    'opt_fields': \"contribution_weight,resource_subtype,supported_goal,supported_goal.name,supported_goal.owner,supported_goal.owner.name,supporting_resource,supporting_resource.name,supporting_resource.resource_subtype\"\n};\ngoalRelationshipsApiInstance.updateGoalRelationship(body, goal_relationship_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.goalrelationships.updateGoalRelationship(goalRelationshipGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ngoal_relationships_api_instance = asana.GoalRelationshipsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The updated fields for the goal relationship.\ngoal_relationship_gid = \"12345\" # str | Globally unique identifier for the goal relationship.\nopts = {\n    'opt_fields': \"contribution_weight,resource_subtype,supported_goal,supported_goal.name,supported_goal.owner,supported_goal.owner.name,supporting_resource,supporting_resource.name,supporting_resource.resource_subtype\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Update a goal relationship\n    api_response = goal_relationships_api_instance.update_goal_relationship(body, goal_relationship_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling GoalRelationshipsApi->update_goal_relationship: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.goal_relationships.update_goal_relationship(goal_relationship_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->goalrelationships->updateGoalRelationship($goal_relationship_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.goal_relationships.update_goal_relationship(goal_relationship_gid: 'goal_relationship_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/goals": {
      "get": {
        "description": "<b>Required scope: </b><code>goals:read</code>\n\nReturns compact goal records.",
        "operationId": "getGoals",
        "parameters": [
          {
            "description": "Globally unique identifier for supporting portfolio.",
            "example": "159874",
            "in": "query",
            "name": "portfolio",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Globally unique identifier for supporting project.",
            "example": "512241",
            "in": "query",
            "name": "project",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Globally unique identifier for supporting task.",
            "example": "78424",
            "in": "query",
            "name": "task",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter to goals with is_workspace_level set to query value. Must be used with the workspace parameter.",
            "example": false,
            "in": "query",
            "name": "is_workspace_level",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "description": "Globally unique identifier for the team.",
            "example": "31326",
            "in": "query",
            "name": "team",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Globally unique identifier for the workspace.",
            "example": "31326",
            "in": "query",
            "name": "workspace",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Globally unique identifiers for the time periods.",
            "example": "221693,506165",
            "in": "query",
            "name": "time_periods",
            "schema": {
              "items": {
                "type": "string"
              },
              "type": "array"
            }
          },
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "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.default_access_level",
              "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.html_text_value",
              "custom_field_settings.custom_field.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_global_to_workspace",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.privacy_setting",
              "custom_field_settings.custom_field.reference_value",
              "custom_field_settings.custom_field.reference_value.name",
              "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.parent.resource_subtype",
              "custom_field_settings.project",
              "custom_field_settings.project.name",
              "custom_field_settings.project.resource_subtype",
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "default_access_level",
              "due_on",
              "followers",
              "followers.name",
              "html_notes",
              "is_workspace_level",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "metric",
              "metric.can_manage",
              "metric.currency_code",
              "metric.current_display_value",
              "metric.current_number_value",
              "metric.initial_number_value",
              "metric.is_custom_weight",
              "metric.precision",
              "metric.progress_source",
              "metric.resource_subtype",
              "metric.target_number_value",
              "metric.unit",
              "name",
              "notes",
              "num_likes",
              "offset",
              "owner",
              "owner.name",
              "path",
              "privacy_setting",
              "start_on",
              "status",
              "team",
              "team.name",
              "time_period",
              "time_period.display_name",
              "time_period.end_on",
              "time_period.period",
              "time_period.start_on",
              "uri",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "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.default_access_level",
                  "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.html_text_value",
                  "custom_field_settings.custom_field.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_global_to_workspace",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.privacy_setting",
                  "custom_field_settings.custom_field.reference_value",
                  "custom_field_settings.custom_field.reference_value.name",
                  "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.parent.resource_subtype",
                  "custom_field_settings.project",
                  "custom_field_settings.project.name",
                  "custom_field_settings.project.resource_subtype",
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "default_access_level",
                  "due_on",
                  "followers",
                  "followers.name",
                  "html_notes",
                  "is_workspace_level",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "metric",
                  "metric.can_manage",
                  "metric.currency_code",
                  "metric.current_display_value",
                  "metric.current_number_value",
                  "metric.initial_number_value",
                  "metric.is_custom_weight",
                  "metric.precision",
                  "metric.progress_source",
                  "metric.resource_subtype",
                  "metric.target_number_value",
                  "metric.unit",
                  "name",
                  "notes",
                  "num_likes",
                  "offset",
                  "owner",
                  "owner.name",
                  "path",
                  "privacy_setting",
                  "start_on",
                  "status",
                  "team",
                  "team.name",
                  "time_period",
                  "time_period.display_name",
                  "time_period.end_on",
                  "time_period.period",
                  "time_period.start_on",
                  "uri",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/GoalCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__GoalResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested goals."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "goals:read"
            ]
          }
        ],
        "summary": "Get goals",
        "tags": [
          "Goals"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1goals/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<JsonElement> result = client.goals.getGoals(timePeriods, workspace, team, isWorkspaceLevel, project, portfolio)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet goalsApiInstance = new Asana.GoalsApi(client);\nlet opts = { \n    'portfolio': \"159874\", \n    'project': \"512241\", \n    'task': \"78424\", \n    'is_workspace_level': false, \n    'team': \"31326\", \n    'workspace': \"31326\", \n    'time_periods': \"221693,506165\", \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,default_access_level,due_on,followers,followers.name,html_notes,is_workspace_level,liked,likes,likes.user,likes.user.name,metric,metric.can_manage,metric.currency_code,metric.current_display_value,metric.current_number_value,metric.initial_number_value,metric.is_custom_weight,metric.precision,metric.progress_source,metric.resource_subtype,metric.target_number_value,metric.unit,name,notes,num_likes,offset,owner,owner.name,path,privacy_setting,start_on,status,team,team.name,time_period,time_period.display_name,time_period.end_on,time_period.period,time_period.start_on,uri,workspace,workspace.name\"\n};\ngoalsApiInstance.getGoals(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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.goals.getGoals({param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ngoals_api_instance = asana.GoalsApi(api_client)\nopts = {\n    'portfolio': \"159874\", # str | Globally unique identifier for supporting portfolio.\n    'project': \"512241\", # str | Globally unique identifier for supporting project.\n    'task': \"78424\", # str | Globally unique identifier for supporting task.\n    'is_workspace_level': False, # bool | Filter to goals with is_workspace_level set to query value. Must be used with the workspace parameter.\n    'team': \"31326\", # str | Globally unique identifier for the team.\n    'workspace': \"31326\", # str | Globally unique identifier for the workspace.\n    'time_periods': \"221693,506165\", # list[str] | Globally unique identifiers for the time periods.\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    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,default_access_level,due_on,followers,followers.name,html_notes,is_workspace_level,liked,likes,likes.user,likes.user.name,metric,metric.can_manage,metric.currency_code,metric.current_display_value,metric.current_number_value,metric.initial_number_value,metric.is_custom_weight,metric.precision,metric.progress_source,metric.resource_subtype,metric.target_number_value,metric.unit,name,notes,num_likes,offset,owner,owner.name,path,privacy_setting,start_on,status,team,team.name,time_period,time_period.display_name,time_period.end_on,time_period.period,time_period.start_on,uri,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get goals\n    api_response = goals_api_instance.get_goals(opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling GoalsApi->get_goals: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.goals.get_goals({'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->goals->getGoals(array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.goals.get_goals(param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "Creates a new goal in a workspace or team.\n\nReturns the full record of the newly created goal.",
        "operationId": "createGoal",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "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.default_access_level",
              "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.html_text_value",
              "custom_field_settings.custom_field.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_global_to_workspace",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.privacy_setting",
              "custom_field_settings.custom_field.reference_value",
              "custom_field_settings.custom_field.reference_value.name",
              "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.parent.resource_subtype",
              "custom_field_settings.project",
              "custom_field_settings.project.name",
              "custom_field_settings.project.resource_subtype",
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "default_access_level",
              "due_on",
              "followers",
              "followers.name",
              "html_notes",
              "is_workspace_level",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "metric",
              "metric.can_manage",
              "metric.currency_code",
              "metric.current_display_value",
              "metric.current_number_value",
              "metric.initial_number_value",
              "metric.is_custom_weight",
              "metric.precision",
              "metric.progress_source",
              "metric.resource_subtype",
              "metric.target_number_value",
              "metric.unit",
              "name",
              "notes",
              "num_likes",
              "owner",
              "owner.name",
              "privacy_setting",
              "start_on",
              "status",
              "team",
              "team.name",
              "time_period",
              "time_period.display_name",
              "time_period.end_on",
              "time_period.period",
              "time_period.start_on",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "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.default_access_level",
                  "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.html_text_value",
                  "custom_field_settings.custom_field.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_global_to_workspace",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.privacy_setting",
                  "custom_field_settings.custom_field.reference_value",
                  "custom_field_settings.custom_field.reference_value.name",
                  "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.parent.resource_subtype",
                  "custom_field_settings.project",
                  "custom_field_settings.project.name",
                  "custom_field_settings.project.resource_subtype",
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "default_access_level",
                  "due_on",
                  "followers",
                  "followers.name",
                  "html_notes",
                  "is_workspace_level",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "metric",
                  "metric.can_manage",
                  "metric.currency_code",
                  "metric.current_display_value",
                  "metric.current_number_value",
                  "metric.initial_number_value",
                  "metric.is_custom_weight",
                  "metric.precision",
                  "metric.progress_source",
                  "metric.resource_subtype",
                  "metric.target_number_value",
                  "metric.unit",
                  "name",
                  "notes",
                  "num_likes",
                  "owner",
                  "owner.name",
                  "privacy_setting",
                  "start_on",
                  "status",
                  "team",
                  "team.name",
                  "time_period",
                  "time_period.display_name",
                  "time_period.end_on",
                  "time_period.period",
                  "time_period.start_on",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/GoalRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The goal to create.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/GoalResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__GoalResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created a new goal."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Create a goal",
        "tags": [
          "Goals"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1goals/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.goals.createGoal()\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet goalsApiInstance = new Asana.GoalsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The goal to create.\nlet opts = { \n    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,default_access_level,due_on,followers,followers.name,html_notes,is_workspace_level,liked,likes,likes.user,likes.user.name,metric,metric.can_manage,metric.currency_code,metric.current_display_value,metric.current_number_value,metric.initial_number_value,metric.is_custom_weight,metric.precision,metric.progress_source,metric.resource_subtype,metric.target_number_value,metric.unit,name,notes,num_likes,owner,owner.name,privacy_setting,start_on,status,team,team.name,time_period,time_period.display_name,time_period.end_on,time_period.period,time_period.start_on,workspace,workspace.name\"\n};\ngoalsApiInstance.createGoal(body, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.goals.createGoal({field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ngoals_api_instance = asana.GoalsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The goal to create.\nopts = {\n    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,default_access_level,due_on,followers,followers.name,html_notes,is_workspace_level,liked,likes,likes.user,likes.user.name,metric,metric.can_manage,metric.currency_code,metric.current_display_value,metric.current_number_value,metric.initial_number_value,metric.is_custom_weight,metric.precision,metric.progress_source,metric.resource_subtype,metric.target_number_value,metric.unit,name,notes,num_likes,owner,owner.name,privacy_setting,start_on,status,team,team.name,time_period,time_period.display_name,time_period.end_on,time_period.period,time_period.start_on,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create a goal\n    api_response = goals_api_instance.create_goal(body, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling GoalsApi->create_goal: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.goals.create_goal({'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->goals->createGoal(array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.goals.create_goal(field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/goals/{goal_gid}": {
      "delete": {
        "description": "A specific, existing goal can be deleted by making a DELETE request on the URL for that goal.\n\nReturns an empty data record.",
        "operationId": "deleteGoal",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully deleted the specified goal."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Delete a goal",
        "tags": [
          "Goals"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1goals~1{goal_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.goals.deleteGoal(goalGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet goalsApiInstance = new Asana.GoalsApi(client);\nlet goal_gid = \"12345\"; // String | Globally unique identifier for the goal.\n\ngoalsApiInstance.deleteGoal(goal_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.goals.deleteGoal(goalGid)\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ngoals_api_instance = asana.GoalsApi(api_client)\ngoal_gid = \"12345\" # str | Globally unique identifier for the goal.\n\n\ntry:\n    # Delete a goal\n    api_response = goals_api_instance.delete_goal(goal_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling GoalsApi->delete_goal: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.goals.delete_goal(goal_gid, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->goals->deleteGoal($goal_gid, array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.goals.delete_goal(goal_gid: 'goal_gid', options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "get": {
        "description": "<b>Required scope: </b><code>goals:read</code>\n\n<table>\n  <tr>\n    <th>Field</th>\n    <th>Required Scope</th>\n  </tr>\n  <tr>\n    <td><code>time_period</code></td>\n    <td><code>time_periods:read</code></td>\n  </tr>\n</table>\n\nReturns the complete goal record for a single goal.",
        "operationId": "getGoal",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "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.default_access_level",
              "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.html_text_value",
              "custom_field_settings.custom_field.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_global_to_workspace",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.privacy_setting",
              "custom_field_settings.custom_field.reference_value",
              "custom_field_settings.custom_field.reference_value.name",
              "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.parent.resource_subtype",
              "custom_field_settings.project",
              "custom_field_settings.project.name",
              "custom_field_settings.project.resource_subtype",
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "default_access_level",
              "due_on",
              "followers",
              "followers.name",
              "html_notes",
              "is_workspace_level",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "metric",
              "metric.can_manage",
              "metric.currency_code",
              "metric.current_display_value",
              "metric.current_number_value",
              "metric.initial_number_value",
              "metric.is_custom_weight",
              "metric.precision",
              "metric.progress_source",
              "metric.resource_subtype",
              "metric.target_number_value",
              "metric.unit",
              "name",
              "notes",
              "num_likes",
              "owner",
              "owner.name",
              "privacy_setting",
              "start_on",
              "status",
              "team",
              "team.name",
              "time_period",
              "time_period.display_name",
              "time_period.end_on",
              "time_period.period",
              "time_period.start_on",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "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.default_access_level",
                  "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.html_text_value",
                  "custom_field_settings.custom_field.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_global_to_workspace",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.privacy_setting",
                  "custom_field_settings.custom_field.reference_value",
                  "custom_field_settings.custom_field.reference_value.name",
                  "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.parent.resource_subtype",
                  "custom_field_settings.project",
                  "custom_field_settings.project.name",
                  "custom_field_settings.project.resource_subtype",
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "default_access_level",
                  "due_on",
                  "followers",
                  "followers.name",
                  "html_notes",
                  "is_workspace_level",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "metric",
                  "metric.can_manage",
                  "metric.currency_code",
                  "metric.current_display_value",
                  "metric.current_number_value",
                  "metric.initial_number_value",
                  "metric.is_custom_weight",
                  "metric.precision",
                  "metric.progress_source",
                  "metric.resource_subtype",
                  "metric.target_number_value",
                  "metric.unit",
                  "name",
                  "notes",
                  "num_likes",
                  "owner",
                  "owner.name",
                  "privacy_setting",
                  "start_on",
                  "status",
                  "team",
                  "team.name",
                  "time_period",
                  "time_period.display_name",
                  "time_period.end_on",
                  "time_period.period",
                  "time_period.start_on",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/GoalResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__GoalResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the record for a single goal."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "goals:read"
            ]
          }
        ],
        "summary": "Get a goal",
        "tags": [
          "Goals"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1goals~1{goal_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.goals.getGoal(goalGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet goalsApiInstance = new Asana.GoalsApi(client);\nlet goal_gid = \"12345\"; // String | Globally unique identifier for the goal.\nlet opts = { \n    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,default_access_level,due_on,followers,followers.name,html_notes,is_workspace_level,liked,likes,likes.user,likes.user.name,metric,metric.can_manage,metric.currency_code,metric.current_display_value,metric.current_number_value,metric.initial_number_value,metric.is_custom_weight,metric.precision,metric.progress_source,metric.resource_subtype,metric.target_number_value,metric.unit,name,notes,num_likes,owner,owner.name,privacy_setting,start_on,status,team,team.name,time_period,time_period.display_name,time_period.end_on,time_period.period,time_period.start_on,workspace,workspace.name\"\n};\ngoalsApiInstance.getGoal(goal_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.goals.getGoal(goalGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ngoals_api_instance = asana.GoalsApi(api_client)\ngoal_gid = \"12345\" # str | Globally unique identifier for the goal.\nopts = {\n    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,default_access_level,due_on,followers,followers.name,html_notes,is_workspace_level,liked,likes,likes.user,likes.user.name,metric,metric.can_manage,metric.currency_code,metric.current_display_value,metric.current_number_value,metric.initial_number_value,metric.is_custom_weight,metric.precision,metric.progress_source,metric.resource_subtype,metric.target_number_value,metric.unit,name,notes,num_likes,owner,owner.name,privacy_setting,start_on,status,team,team.name,time_period,time_period.display_name,time_period.end_on,time_period.period,time_period.start_on,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a goal\n    api_response = goals_api_instance.get_goal(goal_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling GoalsApi->get_goal: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.goals.get_goal(goal_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->goals->getGoal($goal_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.goals.get_goal(goal_gid: 'goal_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/goal_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "put": {
        "description": "An existing goal can be updated by making a PUT request on the URL for\nthat goal. Only the fields provided in the `data` block will be updated;\nany unspecified fields will remain unchanged.\n\nReturns the complete updated goal record.",
        "operationId": "updateGoal",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "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.default_access_level",
              "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.html_text_value",
              "custom_field_settings.custom_field.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_global_to_workspace",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.privacy_setting",
              "custom_field_settings.custom_field.reference_value",
              "custom_field_settings.custom_field.reference_value.name",
              "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.parent.resource_subtype",
              "custom_field_settings.project",
              "custom_field_settings.project.name",
              "custom_field_settings.project.resource_subtype",
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "default_access_level",
              "due_on",
              "followers",
              "followers.name",
              "html_notes",
              "is_workspace_level",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "metric",
              "metric.can_manage",
              "metric.currency_code",
              "metric.current_display_value",
              "metric.current_number_value",
              "metric.initial_number_value",
              "metric.is_custom_weight",
              "metric.precision",
              "metric.progress_source",
              "metric.resource_subtype",
              "metric.target_number_value",
              "metric.unit",
              "name",
              "notes",
              "num_likes",
              "owner",
              "owner.name",
              "privacy_setting",
              "start_on",
              "status",
              "team",
              "team.name",
              "time_period",
              "time_period.display_name",
              "time_period.end_on",
              "time_period.period",
              "time_period.start_on",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "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.default_access_level",
                  "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.html_text_value",
                  "custom_field_settings.custom_field.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_global_to_workspace",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.privacy_setting",
                  "custom_field_settings.custom_field.reference_value",
                  "custom_field_settings.custom_field.reference_value.name",
                  "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.parent.resource_subtype",
                  "custom_field_settings.project",
                  "custom_field_settings.project.name",
                  "custom_field_settings.project.resource_subtype",
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "default_access_level",
                  "due_on",
                  "followers",
                  "followers.name",
                  "html_notes",
                  "is_workspace_level",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "metric",
                  "metric.can_manage",
                  "metric.currency_code",
                  "metric.current_display_value",
                  "metric.current_number_value",
                  "metric.initial_number_value",
                  "metric.is_custom_weight",
                  "metric.precision",
                  "metric.progress_source",
                  "metric.resource_subtype",
                  "metric.target_number_value",
                  "metric.unit",
                  "name",
                  "notes",
                  "num_likes",
                  "owner",
                  "owner.name",
                  "privacy_setting",
                  "start_on",
                  "status",
                  "team",
                  "team.name",
                  "time_period",
                  "time_period.display_name",
                  "time_period.end_on",
                  "time_period.period",
                  "time_period.start_on",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/GoalUpdateRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The updated fields for the goal.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/GoalResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__GoalResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully updated the goal."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Update a goal",
        "tags": [
          "Goals"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1goals~1{goal_gid}/put",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.goals.updateGoal(goalGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet goalsApiInstance = new Asana.GoalsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The updated fields for the goal.\nlet goal_gid = \"12345\"; // String | Globally unique identifier for the goal.\nlet opts = { \n    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,default_access_level,due_on,followers,followers.name,html_notes,is_workspace_level,liked,likes,likes.user,likes.user.name,metric,metric.can_manage,metric.currency_code,metric.current_display_value,metric.current_number_value,metric.initial_number_value,metric.is_custom_weight,metric.precision,metric.progress_source,metric.resource_subtype,metric.target_number_value,metric.unit,name,notes,num_likes,owner,owner.name,privacy_setting,start_on,status,team,team.name,time_period,time_period.display_name,time_period.end_on,time_period.period,time_period.start_on,workspace,workspace.name\"\n};\ngoalsApiInstance.updateGoal(body, goal_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.goals.updateGoal(goalGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ngoals_api_instance = asana.GoalsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The updated fields for the goal.\ngoal_gid = \"12345\" # str | Globally unique identifier for the goal.\nopts = {\n    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,default_access_level,due_on,followers,followers.name,html_notes,is_workspace_level,liked,likes,likes.user,likes.user.name,metric,metric.can_manage,metric.currency_code,metric.current_display_value,metric.current_number_value,metric.initial_number_value,metric.is_custom_weight,metric.precision,metric.progress_source,metric.resource_subtype,metric.target_number_value,metric.unit,name,notes,num_likes,owner,owner.name,privacy_setting,start_on,status,team,team.name,time_period,time_period.display_name,time_period.end_on,time_period.period,time_period.start_on,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Update a goal\n    api_response = goals_api_instance.update_goal(body, goal_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling GoalsApi->update_goal: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.goals.update_goal(goal_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->goals->updateGoal($goal_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.goals.update_goal(goal_gid: 'goal_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/goals/{goal_gid}/addCustomFieldSetting": {
      "parameters": [
        {
          "$ref": "#/components/parameters/goal_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/goals/{goal_gid}/addFollowers": {
      "parameters": [
        {
          "$ref": "#/components/parameters/goal_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "Adds followers to a goal. Returns the goal the followers were added to.\nEach goal can be associated with zero or more followers in the system.\nRequests to add/remove followers, if successful, will return the complete updated goal record, described above.",
        "operationId": "addFollowers",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "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.default_access_level",
              "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.html_text_value",
              "custom_field_settings.custom_field.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_global_to_workspace",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.privacy_setting",
              "custom_field_settings.custom_field.reference_value",
              "custom_field_settings.custom_field.reference_value.name",
              "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.parent.resource_subtype",
              "custom_field_settings.project",
              "custom_field_settings.project.name",
              "custom_field_settings.project.resource_subtype",
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "default_access_level",
              "due_on",
              "followers",
              "followers.name",
              "html_notes",
              "is_workspace_level",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "metric",
              "metric.can_manage",
              "metric.currency_code",
              "metric.current_display_value",
              "metric.current_number_value",
              "metric.initial_number_value",
              "metric.is_custom_weight",
              "metric.precision",
              "metric.progress_source",
              "metric.resource_subtype",
              "metric.target_number_value",
              "metric.unit",
              "name",
              "notes",
              "num_likes",
              "owner",
              "owner.name",
              "privacy_setting",
              "start_on",
              "status",
              "team",
              "team.name",
              "time_period",
              "time_period.display_name",
              "time_period.end_on",
              "time_period.period",
              "time_period.start_on",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "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.default_access_level",
                  "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.html_text_value",
                  "custom_field_settings.custom_field.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_global_to_workspace",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.privacy_setting",
                  "custom_field_settings.custom_field.reference_value",
                  "custom_field_settings.custom_field.reference_value.name",
                  "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.parent.resource_subtype",
                  "custom_field_settings.project",
                  "custom_field_settings.project.name",
                  "custom_field_settings.project.resource_subtype",
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "default_access_level",
                  "due_on",
                  "followers",
                  "followers.name",
                  "html_notes",
                  "is_workspace_level",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "metric",
                  "metric.can_manage",
                  "metric.currency_code",
                  "metric.current_display_value",
                  "metric.current_number_value",
                  "metric.initial_number_value",
                  "metric.is_custom_weight",
                  "metric.precision",
                  "metric.progress_source",
                  "metric.resource_subtype",
                  "metric.target_number_value",
                  "metric.unit",
                  "name",
                  "notes",
                  "num_likes",
                  "owner",
                  "owner.name",
                  "privacy_setting",
                  "start_on",
                  "status",
                  "team",
                  "team.name",
                  "time_period",
                  "time_period.display_name",
                  "time_period.end_on",
                  "time_period.period",
                  "time_period.start_on",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TaskAddFollowersRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The followers to be added as collaborators",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/GoalResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__GoalResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully added users as collaborators."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Add a collaborator to a goal",
        "tags": [
          "Goals"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1goals~1{goal_gid}~1addFollowers/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.goals.addFollowers(goalGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet goalsApiInstance = new Asana.GoalsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The followers to be added as collaborators\nlet goal_gid = \"12345\"; // String | Globally unique identifier for the goal.\nlet opts = { \n    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,default_access_level,due_on,followers,followers.name,html_notes,is_workspace_level,liked,likes,likes.user,likes.user.name,metric,metric.can_manage,metric.currency_code,metric.current_display_value,metric.current_number_value,metric.initial_number_value,metric.is_custom_weight,metric.precision,metric.progress_source,metric.resource_subtype,metric.target_number_value,metric.unit,name,notes,num_likes,owner,owner.name,privacy_setting,start_on,status,team,team.name,time_period,time_period.display_name,time_period.end_on,time_period.period,time_period.start_on,workspace,workspace.name\"\n};\ngoalsApiInstance.addFollowers(body, goal_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.goals.addFollowers(goalGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ngoals_api_instance = asana.GoalsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The followers to be added as collaborators\ngoal_gid = \"12345\" # str | Globally unique identifier for the goal.\nopts = {\n    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,default_access_level,due_on,followers,followers.name,html_notes,is_workspace_level,liked,likes,likes.user,likes.user.name,metric,metric.can_manage,metric.currency_code,metric.current_display_value,metric.current_number_value,metric.initial_number_value,metric.is_custom_weight,metric.precision,metric.progress_source,metric.resource_subtype,metric.target_number_value,metric.unit,name,notes,num_likes,owner,owner.name,privacy_setting,start_on,status,team,team.name,time_period,time_period.display_name,time_period.end_on,time_period.period,time_period.start_on,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Add a collaborator to a goal\n    api_response = goals_api_instance.add_followers(body, goal_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling GoalsApi->add_followers: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.goals.add_followers(goal_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->goals->addFollowers($goal_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.goals.add_followers(goal_gid: 'goal_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/goals/{goal_gid}/addSupportingRelationship": {
      "parameters": [
        {
          "$ref": "#/components/parameters/goal_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "Creates a goal relationship by adding a supporting resource to a given goal.\n\nReturns the newly created goal relationship record.",
        "operationId": "addSupportingRelationship",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "contribution_weight",
              "resource_subtype",
              "supported_goal",
              "supported_goal.name",
              "supported_goal.owner",
              "supported_goal.owner.name",
              "supporting_resource",
              "supporting_resource.name",
              "supporting_resource.resource_subtype"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "contribution_weight",
                  "resource_subtype",
                  "supported_goal",
                  "supported_goal.name",
                  "supported_goal.owner",
                  "supported_goal.owner.name",
                  "supporting_resource",
                  "supporting_resource.name",
                  "supporting_resource.resource_subtype"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/GoalAddSupportingRelationshipRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The supporting resource to be added to the goal",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/GoalRelationshipResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__GoalRelationshipResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created the goal relationship."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Add a supporting goal relationship",
        "tags": [
          "Goal relationships"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1goals~1{goal_gid}~1addSupportingRelationship/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.goalrelationships.addSupportingRelationship(goalGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet goalRelationshipsApiInstance = new Asana.GoalRelationshipsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The supporting resource to be added to the goal\nlet goal_gid = \"12345\"; // String | Globally unique identifier for the goal.\nlet opts = { \n    'opt_fields': \"contribution_weight,resource_subtype,supported_goal,supported_goal.name,supported_goal.owner,supported_goal.owner.name,supporting_resource,supporting_resource.name,supporting_resource.resource_subtype\"\n};\ngoalRelationshipsApiInstance.addSupportingRelationship(body, goal_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.goalrelationships.addSupportingRelationship(goalGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ngoal_relationships_api_instance = asana.GoalRelationshipsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The supporting resource to be added to the goal\ngoal_gid = \"12345\" # str | Globally unique identifier for the goal.\nopts = {\n    'opt_fields': \"contribution_weight,resource_subtype,supported_goal,supported_goal.name,supported_goal.owner,supported_goal.owner.name,supporting_resource,supporting_resource.name,supporting_resource.resource_subtype\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Add a supporting goal relationship\n    api_response = goal_relationships_api_instance.add_supporting_relationship(body, goal_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling GoalRelationshipsApi->add_supporting_relationship: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.goal_relationships.add_supporting_relationship(goal_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->goalrelationships->addSupportingRelationship($goal_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.goal_relationships.add_supporting_relationship(goal_gid: 'goal_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/goals/{goal_gid}/custom_field_settings": {
      "get": {
        "description": "<b>Required scope: </b><code>goals:read</code>\n\nReturns a list of all of the custom fields settings on a goal, in compact form. Note that, as in all queries to collections which return compact representation, `opt_fields` can be used to include more data than is returned in the compact representation. See the [documentation for input/output options](https://developers.asana.com/docs/inputoutput-options) for more information.",
        "operationId": "getCustomFieldSettingsForGoal",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "custom_field",
              "custom_field.asana_created_field",
              "custom_field.created_by",
              "custom_field.created_by.name",
              "custom_field.currency_code",
              "custom_field.custom_label",
              "custom_field.custom_label_position",
              "custom_field.date_value",
              "custom_field.date_value.date",
              "custom_field.date_value.date_time",
              "custom_field.default_access_level",
              "custom_field.description",
              "custom_field.display_value",
              "custom_field.enabled",
              "custom_field.enum_options",
              "custom_field.enum_options.color",
              "custom_field.enum_options.enabled",
              "custom_field.enum_options.name",
              "custom_field.enum_value",
              "custom_field.enum_value.color",
              "custom_field.enum_value.enabled",
              "custom_field.enum_value.name",
              "custom_field.format",
              "custom_field.has_notifications_enabled",
              "custom_field.html_text_value",
              "custom_field.id_prefix",
              "custom_field.input_restrictions",
              "custom_field.is_formula_field",
              "custom_field.is_global_to_workspace",
              "custom_field.is_lookup_field",
              "custom_field.is_value_read_only",
              "custom_field.multi_enum_values",
              "custom_field.multi_enum_values.color",
              "custom_field.multi_enum_values.enabled",
              "custom_field.multi_enum_values.name",
              "custom_field.name",
              "custom_field.number_value",
              "custom_field.people_value",
              "custom_field.people_value.name",
              "custom_field.precision",
              "custom_field.privacy_setting",
              "custom_field.reference_value",
              "custom_field.reference_value.name",
              "custom_field.representation_type",
              "custom_field.resource_subtype",
              "custom_field.text_value",
              "custom_field.type",
              "is_important",
              "offset",
              "parent",
              "parent.name",
              "parent.resource_subtype",
              "path",
              "project",
              "project.name",
              "project.resource_subtype",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "custom_field",
                  "custom_field.asana_created_field",
                  "custom_field.created_by",
                  "custom_field.created_by.name",
                  "custom_field.currency_code",
                  "custom_field.custom_label",
                  "custom_field.custom_label_position",
                  "custom_field.date_value",
                  "custom_field.date_value.date",
                  "custom_field.date_value.date_time",
                  "custom_field.default_access_level",
                  "custom_field.description",
                  "custom_field.display_value",
                  "custom_field.enabled",
                  "custom_field.enum_options",
                  "custom_field.enum_options.color",
                  "custom_field.enum_options.enabled",
                  "custom_field.enum_options.name",
                  "custom_field.enum_value",
                  "custom_field.enum_value.color",
                  "custom_field.enum_value.enabled",
                  "custom_field.enum_value.name",
                  "custom_field.format",
                  "custom_field.has_notifications_enabled",
                  "custom_field.html_text_value",
                  "custom_field.id_prefix",
                  "custom_field.input_restrictions",
                  "custom_field.is_formula_field",
                  "custom_field.is_global_to_workspace",
                  "custom_field.is_lookup_field",
                  "custom_field.is_value_read_only",
                  "custom_field.multi_enum_values",
                  "custom_field.multi_enum_values.color",
                  "custom_field.multi_enum_values.enabled",
                  "custom_field.multi_enum_values.name",
                  "custom_field.name",
                  "custom_field.number_value",
                  "custom_field.people_value",
                  "custom_field.people_value.name",
                  "custom_field.precision",
                  "custom_field.privacy_setting",
                  "custom_field.reference_value",
                  "custom_field.reference_value.name",
                  "custom_field.representation_type",
                  "custom_field.resource_subtype",
                  "custom_field.text_value",
                  "custom_field.type",
                  "is_important",
                  "offset",
                  "parent",
                  "parent.name",
                  "parent.resource_subtype",
                  "path",
                  "project",
                  "project.name",
                  "project.resource_subtype",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/CustomFieldSettingResponse"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__CustomFieldSettingResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved custom field settings objects for a goal."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "goals:read"
            ]
          }
        ],
        "summary": "Get a goal's custom fields",
        "tags": [
          "Custom field settings"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1goals~1{goal_gid}~1custom_field_settings/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet customFieldSettingsApiInstance = new Asana.CustomFieldSettingsApi(client);\nlet goal_gid = \"12345\"; // String | Globally unique identifier for the goal.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"custom_field,custom_field.asana_created_field,custom_field.created_by,custom_field.created_by.name,custom_field.currency_code,custom_field.custom_label,custom_field.custom_label_position,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.default_access_level,custom_field.description,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.format,custom_field.has_notifications_enabled,custom_field.html_text_value,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_global_to_workspace,custom_field.is_lookup_field,custom_field.is_value_read_only,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.people_value,custom_field.people_value.name,custom_field.precision,custom_field.privacy_setting,custom_field.reference_value,custom_field.reference_value.name,custom_field.representation_type,custom_field.resource_subtype,custom_field.text_value,custom_field.type,is_important,offset,parent,parent.name,parent.resource_subtype,path,project,project.name,project.resource_subtype,uri\"\n};\ncustomFieldSettingsApiInstance.getCustomFieldSettingsForGoal(goal_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ncustom_field_settings_api_instance = asana.CustomFieldSettingsApi(api_client)\ngoal_gid = \"12345\" # str | Globally unique identifier for the goal.\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    'opt_fields': \"custom_field,custom_field.asana_created_field,custom_field.created_by,custom_field.created_by.name,custom_field.currency_code,custom_field.custom_label,custom_field.custom_label_position,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.default_access_level,custom_field.description,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.format,custom_field.has_notifications_enabled,custom_field.html_text_value,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_global_to_workspace,custom_field.is_lookup_field,custom_field.is_value_read_only,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.people_value,custom_field.people_value.name,custom_field.precision,custom_field.privacy_setting,custom_field.reference_value,custom_field.reference_value.name,custom_field.representation_type,custom_field.resource_subtype,custom_field.text_value,custom_field.type,is_important,offset,parent,parent.name,parent.resource_subtype,path,project,project.name,project.resource_subtype,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a goal's custom fields\n    api_response = custom_field_settings_api_instance.get_custom_field_settings_for_goal(goal_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling CustomFieldSettingsApi->get_custom_field_settings_for_goal: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/goal_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/goals/{goal_gid}/parentGoals": {
      "get": {
        "description": "<b>Required scope: </b><code>goals:read</code>\n\nReturns a compact representation of all of the parent goals of a goal.",
        "operationId": "getParentGoalsForGoal",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "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.default_access_level",
              "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.html_text_value",
              "custom_field_settings.custom_field.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_global_to_workspace",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.privacy_setting",
              "custom_field_settings.custom_field.reference_value",
              "custom_field_settings.custom_field.reference_value.name",
              "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.parent.resource_subtype",
              "custom_field_settings.project",
              "custom_field_settings.project.name",
              "custom_field_settings.project.resource_subtype",
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "default_access_level",
              "due_on",
              "followers",
              "followers.name",
              "html_notes",
              "is_workspace_level",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "metric",
              "metric.can_manage",
              "metric.currency_code",
              "metric.current_display_value",
              "metric.current_number_value",
              "metric.initial_number_value",
              "metric.is_custom_weight",
              "metric.precision",
              "metric.progress_source",
              "metric.resource_subtype",
              "metric.target_number_value",
              "metric.unit",
              "name",
              "notes",
              "num_likes",
              "owner",
              "owner.name",
              "privacy_setting",
              "start_on",
              "status",
              "team",
              "team.name",
              "time_period",
              "time_period.display_name",
              "time_period.end_on",
              "time_period.period",
              "time_period.start_on",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "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.default_access_level",
                  "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.html_text_value",
                  "custom_field_settings.custom_field.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_global_to_workspace",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.privacy_setting",
                  "custom_field_settings.custom_field.reference_value",
                  "custom_field_settings.custom_field.reference_value.name",
                  "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.parent.resource_subtype",
                  "custom_field_settings.project",
                  "custom_field_settings.project.name",
                  "custom_field_settings.project.resource_subtype",
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "default_access_level",
                  "due_on",
                  "followers",
                  "followers.name",
                  "html_notes",
                  "is_workspace_level",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "metric",
                  "metric.can_manage",
                  "metric.currency_code",
                  "metric.current_display_value",
                  "metric.current_number_value",
                  "metric.initial_number_value",
                  "metric.is_custom_weight",
                  "metric.precision",
                  "metric.progress_source",
                  "metric.resource_subtype",
                  "metric.target_number_value",
                  "metric.unit",
                  "name",
                  "notes",
                  "num_likes",
                  "owner",
                  "owner.name",
                  "privacy_setting",
                  "start_on",
                  "status",
                  "team",
                  "team.name",
                  "time_period",
                  "time_period.display_name",
                  "time_period.end_on",
                  "time_period.period",
                  "time_period.start_on",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/GoalCompact"
                          },
                          "type": "array"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__GoalResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the specified goal's parent goals."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "goals:read"
            ]
          }
        ],
        "summary": "Get parent goals from a goal",
        "tags": [
          "Goals"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1goals~1{goal_gid}~1parentGoals/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<JsonElement> result = client.goals.getParentGoalsForGoal(goalGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet goalsApiInstance = new Asana.GoalsApi(client);\nlet goal_gid = \"12345\"; // String | Globally unique identifier for the goal.\nlet opts = { \n    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,default_access_level,due_on,followers,followers.name,html_notes,is_workspace_level,liked,likes,likes.user,likes.user.name,metric,metric.can_manage,metric.currency_code,metric.current_display_value,metric.current_number_value,metric.initial_number_value,metric.is_custom_weight,metric.precision,metric.progress_source,metric.resource_subtype,metric.target_number_value,metric.unit,name,notes,num_likes,owner,owner.name,privacy_setting,start_on,status,team,team.name,time_period,time_period.display_name,time_period.end_on,time_period.period,time_period.start_on,workspace,workspace.name\"\n};\ngoalsApiInstance.getParentGoalsForGoal(goal_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.goals.getParentGoalsForGoal(goalGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ngoals_api_instance = asana.GoalsApi(api_client)\ngoal_gid = \"12345\" # str | Globally unique identifier for the goal.\nopts = {\n    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,default_access_level,due_on,followers,followers.name,html_notes,is_workspace_level,liked,likes,likes.user,likes.user.name,metric,metric.can_manage,metric.currency_code,metric.current_display_value,metric.current_number_value,metric.initial_number_value,metric.is_custom_weight,metric.precision,metric.progress_source,metric.resource_subtype,metric.target_number_value,metric.unit,name,notes,num_likes,owner,owner.name,privacy_setting,start_on,status,team,team.name,time_period,time_period.display_name,time_period.end_on,time_period.period,time_period.start_on,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get parent goals from a goal\n    api_response = goals_api_instance.get_parent_goals_for_goal(goal_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling GoalsApi->get_parent_goals_for_goal: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.goals.get_parent_goals_for_goal(goal_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->goals->getParentGoalsForGoal($goal_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.goals.get_parent_goals_for_goal(goal_gid: 'goal_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/goal_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/goals/{goal_gid}/removeCustomFieldSetting": {
      "parameters": [
        {
          "$ref": "#/components/parameters/goal_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>goals:write</code>\n\nRemoves a custom field setting from a goal.",
        "operationId": "removeCustomFieldSettingForGoal",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/RemoveCustomFieldSettingRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Information about the custom field setting being removed.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully removed the custom field from the goal."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "goals:write"
            ]
          }
        ],
        "summary": "Remove a custom field from a goal",
        "tags": [
          "Goals"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1goals~1{goal_gid}~1removeCustomFieldSetting/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet goalsApiInstance = new Asana.GoalsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | Information about the custom field setting being removed.\nlet goal_gid = \"12345\"; // String | Globally unique identifier for the goal.\n\ngoalsApiInstance.removeCustomFieldSettingForGoal(body, goal_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ngoals_api_instance = asana.GoalsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | Information about the custom field setting being removed.\ngoal_gid = \"12345\" # str | Globally unique identifier for the goal.\n\n\ntry:\n    # Remove a custom field from a goal\n    api_response = goals_api_instance.remove_custom_field_setting_for_goal(body, goal_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling GoalsApi->remove_custom_field_setting_for_goal: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/goals/{goal_gid}/removeFollowers": {
      "parameters": [
        {
          "$ref": "#/components/parameters/goal_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "Removes followers from a goal. Returns the goal the followers were removed from.\nEach goal can be associated with zero or more followers in the system.\nRequests to add/remove followers, if successful, will return the complete updated goal record, described above.",
        "operationId": "removeFollowers",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "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.default_access_level",
              "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.html_text_value",
              "custom_field_settings.custom_field.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_global_to_workspace",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.privacy_setting",
              "custom_field_settings.custom_field.reference_value",
              "custom_field_settings.custom_field.reference_value.name",
              "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.parent.resource_subtype",
              "custom_field_settings.project",
              "custom_field_settings.project.name",
              "custom_field_settings.project.resource_subtype",
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "default_access_level",
              "due_on",
              "followers",
              "followers.name",
              "html_notes",
              "is_workspace_level",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "metric",
              "metric.can_manage",
              "metric.currency_code",
              "metric.current_display_value",
              "metric.current_number_value",
              "metric.initial_number_value",
              "metric.is_custom_weight",
              "metric.precision",
              "metric.progress_source",
              "metric.resource_subtype",
              "metric.target_number_value",
              "metric.unit",
              "name",
              "notes",
              "num_likes",
              "owner",
              "owner.name",
              "privacy_setting",
              "start_on",
              "status",
              "team",
              "team.name",
              "time_period",
              "time_period.display_name",
              "time_period.end_on",
              "time_period.period",
              "time_period.start_on",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "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.default_access_level",
                  "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.html_text_value",
                  "custom_field_settings.custom_field.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_global_to_workspace",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.privacy_setting",
                  "custom_field_settings.custom_field.reference_value",
                  "custom_field_settings.custom_field.reference_value.name",
                  "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.parent.resource_subtype",
                  "custom_field_settings.project",
                  "custom_field_settings.project.name",
                  "custom_field_settings.project.resource_subtype",
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "default_access_level",
                  "due_on",
                  "followers",
                  "followers.name",
                  "html_notes",
                  "is_workspace_level",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "metric",
                  "metric.can_manage",
                  "metric.currency_code",
                  "metric.current_display_value",
                  "metric.current_number_value",
                  "metric.initial_number_value",
                  "metric.is_custom_weight",
                  "metric.precision",
                  "metric.progress_source",
                  "metric.resource_subtype",
                  "metric.target_number_value",
                  "metric.unit",
                  "name",
                  "notes",
                  "num_likes",
                  "owner",
                  "owner.name",
                  "privacy_setting",
                  "start_on",
                  "status",
                  "team",
                  "team.name",
                  "time_period",
                  "time_period.display_name",
                  "time_period.end_on",
                  "time_period.period",
                  "time_period.start_on",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TaskAddFollowersRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The followers to be removed as collaborators",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/GoalResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__GoalResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully removed users as collaborators."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Remove a collaborator from a goal",
        "tags": [
          "Goals"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1goals~1{goal_gid}~1removeFollowers/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.goals.removeFollowers(goalGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet goalsApiInstance = new Asana.GoalsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The followers to be removed as collaborators\nlet goal_gid = \"12345\"; // String | Globally unique identifier for the goal.\nlet opts = { \n    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,default_access_level,due_on,followers,followers.name,html_notes,is_workspace_level,liked,likes,likes.user,likes.user.name,metric,metric.can_manage,metric.currency_code,metric.current_display_value,metric.current_number_value,metric.initial_number_value,metric.is_custom_weight,metric.precision,metric.progress_source,metric.resource_subtype,metric.target_number_value,metric.unit,name,notes,num_likes,owner,owner.name,privacy_setting,start_on,status,team,team.name,time_period,time_period.display_name,time_period.end_on,time_period.period,time_period.start_on,workspace,workspace.name\"\n};\ngoalsApiInstance.removeFollowers(body, goal_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.goals.removeFollowers(goalGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ngoals_api_instance = asana.GoalsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The followers to be removed as collaborators\ngoal_gid = \"12345\" # str | Globally unique identifier for the goal.\nopts = {\n    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,default_access_level,due_on,followers,followers.name,html_notes,is_workspace_level,liked,likes,likes.user,likes.user.name,metric,metric.can_manage,metric.currency_code,metric.current_display_value,metric.current_number_value,metric.initial_number_value,metric.is_custom_weight,metric.precision,metric.progress_source,metric.resource_subtype,metric.target_number_value,metric.unit,name,notes,num_likes,owner,owner.name,privacy_setting,start_on,status,team,team.name,time_period,time_period.display_name,time_period.end_on,time_period.period,time_period.start_on,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Remove a collaborator from a goal\n    api_response = goals_api_instance.remove_followers(body, goal_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling GoalsApi->remove_followers: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.goals.remove_followers(goal_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->goals->removeFollowers($goal_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.goals.remove_followers(goal_gid: 'goal_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/goals/{goal_gid}/removeSupportingRelationship": {
      "parameters": [
        {
          "$ref": "#/components/parameters/goal_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "Removes a goal relationship for a given parent goal.",
        "operationId": "removeSupportingRelationship",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/GoalRemoveSupportingRelationshipRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The supporting resource to be removed from the goal",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully removed the goal relationship."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Removes a supporting goal relationship",
        "tags": [
          "Goal relationships"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1goals~1{goal_gid}~1removeSupportingRelationship/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.goalrelationships.removeSupportingRelationship(goalGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet goalRelationshipsApiInstance = new Asana.GoalRelationshipsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The supporting resource to be removed from the goal\nlet goal_gid = \"12345\"; // String | Globally unique identifier for the goal.\n\ngoalRelationshipsApiInstance.removeSupportingRelationship(body, goal_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.goalrelationships.removeSupportingRelationship(goalGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ngoal_relationships_api_instance = asana.GoalRelationshipsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The supporting resource to be removed from the goal\ngoal_gid = \"12345\" # str | Globally unique identifier for the goal.\n\n\ntry:\n    # Removes a supporting goal relationship\n    api_response = goal_relationships_api_instance.remove_supporting_relationship(body, goal_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling GoalRelationshipsApi->remove_supporting_relationship: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.goal_relationships.remove_supporting_relationship(goal_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->goalrelationships->removeSupportingRelationship($goal_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.goal_relationships.remove_supporting_relationship(goal_gid: 'goal_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/goals/{goal_gid}/setMetric": {
      "parameters": [
        {
          "$ref": "#/components/parameters/goal_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "Creates and adds a goal metric to a specified goal. Note that this replaces an existing goal metric if one already exists.",
        "operationId": "createGoalMetric",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "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.default_access_level",
              "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.html_text_value",
              "custom_field_settings.custom_field.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_global_to_workspace",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.privacy_setting",
              "custom_field_settings.custom_field.reference_value",
              "custom_field_settings.custom_field.reference_value.name",
              "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.parent.resource_subtype",
              "custom_field_settings.project",
              "custom_field_settings.project.name",
              "custom_field_settings.project.resource_subtype",
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "default_access_level",
              "due_on",
              "followers",
              "followers.name",
              "html_notes",
              "is_workspace_level",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "metric",
              "metric.can_manage",
              "metric.currency_code",
              "metric.current_display_value",
              "metric.current_number_value",
              "metric.initial_number_value",
              "metric.is_custom_weight",
              "metric.precision",
              "metric.progress_source",
              "metric.resource_subtype",
              "metric.target_number_value",
              "metric.unit",
              "name",
              "notes",
              "num_likes",
              "owner",
              "owner.name",
              "privacy_setting",
              "start_on",
              "status",
              "team",
              "team.name",
              "time_period",
              "time_period.display_name",
              "time_period.end_on",
              "time_period.period",
              "time_period.start_on",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "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.default_access_level",
                  "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.html_text_value",
                  "custom_field_settings.custom_field.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_global_to_workspace",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.privacy_setting",
                  "custom_field_settings.custom_field.reference_value",
                  "custom_field_settings.custom_field.reference_value.name",
                  "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.parent.resource_subtype",
                  "custom_field_settings.project",
                  "custom_field_settings.project.name",
                  "custom_field_settings.project.resource_subtype",
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "default_access_level",
                  "due_on",
                  "followers",
                  "followers.name",
                  "html_notes",
                  "is_workspace_level",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "metric",
                  "metric.can_manage",
                  "metric.currency_code",
                  "metric.current_display_value",
                  "metric.current_number_value",
                  "metric.initial_number_value",
                  "metric.is_custom_weight",
                  "metric.precision",
                  "metric.progress_source",
                  "metric.resource_subtype",
                  "metric.target_number_value",
                  "metric.unit",
                  "name",
                  "notes",
                  "num_likes",
                  "owner",
                  "owner.name",
                  "privacy_setting",
                  "start_on",
                  "status",
                  "team",
                  "team.name",
                  "time_period",
                  "time_period.display_name",
                  "time_period.end_on",
                  "time_period.period",
                  "time_period.start_on",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/GoalMetricRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The goal metric to create.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/GoalResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__GoalResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created a new goal metric."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Create a goal metric",
        "tags": [
          "Goals"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1goals~1{goal_gid}~1setMetric/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.goals.createGoalMetric(goalGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet goalsApiInstance = new Asana.GoalsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The goal metric to create.\nlet goal_gid = \"12345\"; // String | Globally unique identifier for the goal.\nlet opts = { \n    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,default_access_level,due_on,followers,followers.name,html_notes,is_workspace_level,liked,likes,likes.user,likes.user.name,metric,metric.can_manage,metric.currency_code,metric.current_display_value,metric.current_number_value,metric.initial_number_value,metric.is_custom_weight,metric.precision,metric.progress_source,metric.resource_subtype,metric.target_number_value,metric.unit,name,notes,num_likes,owner,owner.name,privacy_setting,start_on,status,team,team.name,time_period,time_period.display_name,time_period.end_on,time_period.period,time_period.start_on,workspace,workspace.name\"\n};\ngoalsApiInstance.createGoalMetric(body, goal_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.goals.createGoalMetric(goalGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ngoals_api_instance = asana.GoalsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The goal metric to create.\ngoal_gid = \"12345\" # str | Globally unique identifier for the goal.\nopts = {\n    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,default_access_level,due_on,followers,followers.name,html_notes,is_workspace_level,liked,likes,likes.user,likes.user.name,metric,metric.can_manage,metric.currency_code,metric.current_display_value,metric.current_number_value,metric.initial_number_value,metric.is_custom_weight,metric.precision,metric.progress_source,metric.resource_subtype,metric.target_number_value,metric.unit,name,notes,num_likes,owner,owner.name,privacy_setting,start_on,status,team,team.name,time_period,time_period.display_name,time_period.end_on,time_period.period,time_period.start_on,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create a goal metric\n    api_response = goals_api_instance.create_goal_metric(body, goal_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling GoalsApi->create_goal_metric: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.goals.create_goal_metric(goal_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->goals->createGoalMetric($goal_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.goals.create_goal_metric(goal_gid: 'goal_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/goals/{goal_gid}/setMetricCurrentValue": {
      "parameters": [
        {
          "$ref": "#/components/parameters/goal_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "Updates a goal's existing metric's `current_number_value` if one exists,\notherwise responds with a 400 status code.\n\nReturns the complete updated goal metric record.",
        "operationId": "updateGoalMetric",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "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.default_access_level",
              "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.html_text_value",
              "custom_field_settings.custom_field.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_global_to_workspace",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.privacy_setting",
              "custom_field_settings.custom_field.reference_value",
              "custom_field_settings.custom_field.reference_value.name",
              "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.parent.resource_subtype",
              "custom_field_settings.project",
              "custom_field_settings.project.name",
              "custom_field_settings.project.resource_subtype",
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "default_access_level",
              "due_on",
              "followers",
              "followers.name",
              "html_notes",
              "is_workspace_level",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "metric",
              "metric.can_manage",
              "metric.currency_code",
              "metric.current_display_value",
              "metric.current_number_value",
              "metric.initial_number_value",
              "metric.is_custom_weight",
              "metric.precision",
              "metric.progress_source",
              "metric.resource_subtype",
              "metric.target_number_value",
              "metric.unit",
              "name",
              "notes",
              "num_likes",
              "owner",
              "owner.name",
              "privacy_setting",
              "start_on",
              "status",
              "team",
              "team.name",
              "time_period",
              "time_period.display_name",
              "time_period.end_on",
              "time_period.period",
              "time_period.start_on",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "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.default_access_level",
                  "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.html_text_value",
                  "custom_field_settings.custom_field.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_global_to_workspace",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.privacy_setting",
                  "custom_field_settings.custom_field.reference_value",
                  "custom_field_settings.custom_field.reference_value.name",
                  "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.parent.resource_subtype",
                  "custom_field_settings.project",
                  "custom_field_settings.project.name",
                  "custom_field_settings.project.resource_subtype",
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "default_access_level",
                  "due_on",
                  "followers",
                  "followers.name",
                  "html_notes",
                  "is_workspace_level",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "metric",
                  "metric.can_manage",
                  "metric.currency_code",
                  "metric.current_display_value",
                  "metric.current_number_value",
                  "metric.initial_number_value",
                  "metric.is_custom_weight",
                  "metric.precision",
                  "metric.progress_source",
                  "metric.resource_subtype",
                  "metric.target_number_value",
                  "metric.unit",
                  "name",
                  "notes",
                  "num_likes",
                  "owner",
                  "owner.name",
                  "privacy_setting",
                  "start_on",
                  "status",
                  "team",
                  "team.name",
                  "time_period",
                  "time_period.display_name",
                  "time_period.end_on",
                  "time_period.period",
                  "time_period.start_on",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/GoalMetricCurrentValueRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The updated fields for the goal metric.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/GoalResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__GoalResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully updated the goal metric."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Update a goal metric",
        "tags": [
          "Goals"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1goals~1{goal_gid}~1setMetricCurrentValue/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.goals.updateGoalMetric(goalGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet goalsApiInstance = new Asana.GoalsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The updated fields for the goal metric.\nlet goal_gid = \"12345\"; // String | Globally unique identifier for the goal.\nlet opts = { \n    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,default_access_level,due_on,followers,followers.name,html_notes,is_workspace_level,liked,likes,likes.user,likes.user.name,metric,metric.can_manage,metric.currency_code,metric.current_display_value,metric.current_number_value,metric.initial_number_value,metric.is_custom_weight,metric.precision,metric.progress_source,metric.resource_subtype,metric.target_number_value,metric.unit,name,notes,num_likes,owner,owner.name,privacy_setting,start_on,status,team,team.name,time_period,time_period.display_name,time_period.end_on,time_period.period,time_period.start_on,workspace,workspace.name\"\n};\ngoalsApiInstance.updateGoalMetric(body, goal_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.goals.updateGoalMetric(goalGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ngoals_api_instance = asana.GoalsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The updated fields for the goal metric.\ngoal_gid = \"12345\" # str | Globally unique identifier for the goal.\nopts = {\n    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,default_access_level,due_on,followers,followers.name,html_notes,is_workspace_level,liked,likes,likes.user,likes.user.name,metric,metric.can_manage,metric.currency_code,metric.current_display_value,metric.current_number_value,metric.initial_number_value,metric.is_custom_weight,metric.precision,metric.progress_source,metric.resource_subtype,metric.target_number_value,metric.unit,name,notes,num_likes,owner,owner.name,privacy_setting,start_on,status,team,team.name,time_period,time_period.display_name,time_period.end_on,time_period.period,time_period.start_on,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Update a goal metric\n    api_response = goals_api_instance.update_goal_metric(body, goal_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling GoalsApi->update_goal_metric: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.goals.update_goal_metric(goal_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->goals->updateGoalMetric($goal_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.goals.update_goal_metric(goal_gid: 'goal_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/goals/{goal_gid}/stories": {
      "get": {
        "description": "<b>Required scope: </b><code>stories:read</code>\n\nReturns the compact records for all stories on the goal.",
        "operationId": "getStoriesForGoal",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "$ref": "#/components/parameters/story_created_after"
          },
          {
            "$ref": "#/components/parameters/story_resource_subtype"
          },
          {
            "$ref": "#/components/parameters/story_sort_ascending"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "anchor_gid",
              "assignee",
              "assignee.name",
              "comment_gid",
              "created_at",
              "created_by",
              "created_by.name",
              "custom_field",
              "custom_field.date_value",
              "custom_field.date_value.date",
              "custom_field.date_value.date_time",
              "custom_field.display_value",
              "custom_field.enabled",
              "custom_field.enum_options",
              "custom_field.enum_options.color",
              "custom_field.enum_options.enabled",
              "custom_field.enum_options.name",
              "custom_field.enum_value",
              "custom_field.enum_value.color",
              "custom_field.enum_value.enabled",
              "custom_field.enum_value.name",
              "custom_field.id_prefix",
              "custom_field.input_restrictions",
              "custom_field.is_formula_field",
              "custom_field.is_lookup_field",
              "custom_field.multi_enum_values",
              "custom_field.multi_enum_values.color",
              "custom_field.multi_enum_values.enabled",
              "custom_field.multi_enum_values.name",
              "custom_field.name",
              "custom_field.number_value",
              "custom_field.representation_type",
              "custom_field.text_value",
              "custom_field.type",
              "dependency",
              "dependency.created_by",
              "dependency.name",
              "dependency.resource_subtype",
              "duplicate_of",
              "duplicate_of.created_by",
              "duplicate_of.name",
              "duplicate_of.resource_subtype",
              "duplicated_from",
              "duplicated_from.created_by",
              "duplicated_from.name",
              "duplicated_from.resource_subtype",
              "follower",
              "follower.name",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_text",
              "is_editable",
              "is_edited",
              "is_pinned",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "new_approval_status",
              "new_date_value",
              "new_dates",
              "new_dates.due_at",
              "new_dates.due_on",
              "new_dates.start_on",
              "new_enum_value",
              "new_enum_value.color",
              "new_enum_value.enabled",
              "new_enum_value.name",
              "new_multi_enum_values",
              "new_multi_enum_values.color",
              "new_multi_enum_values.enabled",
              "new_multi_enum_values.name",
              "new_name",
              "new_number_value",
              "new_people_value",
              "new_people_value.name",
              "new_resource_subtype",
              "new_section",
              "new_section.name",
              "new_text_value",
              "num_hearts",
              "num_likes",
              "offset",
              "old_approval_status",
              "old_date_value",
              "old_dates",
              "old_dates.due_at",
              "old_dates.due_on",
              "old_dates.start_on",
              "old_enum_value",
              "old_enum_value.color",
              "old_enum_value.enabled",
              "old_enum_value.name",
              "old_multi_enum_values",
              "old_multi_enum_values.color",
              "old_multi_enum_values.enabled",
              "old_multi_enum_values.name",
              "old_name",
              "old_number_value",
              "old_people_value",
              "old_people_value.name",
              "old_resource_subtype",
              "old_section",
              "old_section.name",
              "old_text_value",
              "path",
              "previews",
              "previews.fallback",
              "previews.footer",
              "previews.header",
              "previews.header_link",
              "previews.html_text",
              "previews.text",
              "previews.title",
              "previews.title_link",
              "project",
              "project.name",
              "project.resource_subtype",
              "reaction_summary",
              "reaction_summary.count",
              "reaction_summary.emoji_base",
              "reaction_summary.reacted",
              "reaction_summary.variant",
              "resource_subtype",
              "source",
              "sticker_name",
              "story",
              "story.anchor_gid",
              "story.comment_gid",
              "story.created_at",
              "story.created_by",
              "story.created_by.name",
              "story.resource_subtype",
              "story.text",
              "tag",
              "tag.name",
              "target",
              "target.created_by",
              "target.name",
              "target.resource_subtype",
              "task",
              "task.created_by",
              "task.name",
              "task.resource_subtype",
              "text",
              "type",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "anchor_gid",
                  "assignee",
                  "assignee.name",
                  "comment_gid",
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "custom_field",
                  "custom_field.date_value",
                  "custom_field.date_value.date",
                  "custom_field.date_value.date_time",
                  "custom_field.display_value",
                  "custom_field.enabled",
                  "custom_field.enum_options",
                  "custom_field.enum_options.color",
                  "custom_field.enum_options.enabled",
                  "custom_field.enum_options.name",
                  "custom_field.enum_value",
                  "custom_field.enum_value.color",
                  "custom_field.enum_value.enabled",
                  "custom_field.enum_value.name",
                  "custom_field.id_prefix",
                  "custom_field.input_restrictions",
                  "custom_field.is_formula_field",
                  "custom_field.is_lookup_field",
                  "custom_field.multi_enum_values",
                  "custom_field.multi_enum_values.color",
                  "custom_field.multi_enum_values.enabled",
                  "custom_field.multi_enum_values.name",
                  "custom_field.name",
                  "custom_field.number_value",
                  "custom_field.representation_type",
                  "custom_field.text_value",
                  "custom_field.type",
                  "dependency",
                  "dependency.created_by",
                  "dependency.name",
                  "dependency.resource_subtype",
                  "duplicate_of",
                  "duplicate_of.created_by",
                  "duplicate_of.name",
                  "duplicate_of.resource_subtype",
                  "duplicated_from",
                  "duplicated_from.created_by",
                  "duplicated_from.name",
                  "duplicated_from.resource_subtype",
                  "follower",
                  "follower.name",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_text",
                  "is_editable",
                  "is_edited",
                  "is_pinned",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "new_approval_status",
                  "new_date_value",
                  "new_dates",
                  "new_dates.due_at",
                  "new_dates.due_on",
                  "new_dates.start_on",
                  "new_enum_value",
                  "new_enum_value.color",
                  "new_enum_value.enabled",
                  "new_enum_value.name",
                  "new_multi_enum_values",
                  "new_multi_enum_values.color",
                  "new_multi_enum_values.enabled",
                  "new_multi_enum_values.name",
                  "new_name",
                  "new_number_value",
                  "new_people_value",
                  "new_people_value.name",
                  "new_resource_subtype",
                  "new_section",
                  "new_section.name",
                  "new_text_value",
                  "num_hearts",
                  "num_likes",
                  "offset",
                  "old_approval_status",
                  "old_date_value",
                  "old_dates",
                  "old_dates.due_at",
                  "old_dates.due_on",
                  "old_dates.start_on",
                  "old_enum_value",
                  "old_enum_value.color",
                  "old_enum_value.enabled",
                  "old_enum_value.name",
                  "old_multi_enum_values",
                  "old_multi_enum_values.color",
                  "old_multi_enum_values.enabled",
                  "old_multi_enum_values.name",
                  "old_name",
                  "old_number_value",
                  "old_people_value",
                  "old_people_value.name",
                  "old_resource_subtype",
                  "old_section",
                  "old_section.name",
                  "old_text_value",
                  "path",
                  "previews",
                  "previews.fallback",
                  "previews.footer",
                  "previews.header",
                  "previews.header_link",
                  "previews.html_text",
                  "previews.text",
                  "previews.title",
                  "previews.title_link",
                  "project",
                  "project.name",
                  "project.resource_subtype",
                  "reaction_summary",
                  "reaction_summary.count",
                  "reaction_summary.emoji_base",
                  "reaction_summary.reacted",
                  "reaction_summary.variant",
                  "resource_subtype",
                  "source",
                  "sticker_name",
                  "story",
                  "story.anchor_gid",
                  "story.comment_gid",
                  "story.created_at",
                  "story.created_by",
                  "story.created_by.name",
                  "story.resource_subtype",
                  "story.text",
                  "tag",
                  "tag.name",
                  "target",
                  "target.created_by",
                  "target.name",
                  "target.resource_subtype",
                  "task",
                  "task.created_by",
                  "task.name",
                  "task.resource_subtype",
                  "text",
                  "type",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/StoryCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__StoryResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the specified goal's stories."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "stories:read"
            ]
          }
        ],
        "summary": "Get stories from a goal",
        "tags": [
          "Stories"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1goals~1{goal_gid}~1stories/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet storiesApiInstance = new Asana.StoriesApi(client);\nlet goal_gid = \"12345\"; // String | Globally unique identifier for the goal.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'created_after': \"2012-02-22T02:06:58.158Z\", \n    'resource_subtype': \"comment_added\", \n    'sort_ascending': true, \n    'opt_fields': \"anchor_gid,assignee,assignee.name,comment_gid,created_at,created_by,created_by.name,custom_field,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_lookup_field,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.representation_type,custom_field.text_value,custom_field.type,dependency,dependency.created_by,dependency.name,dependency.resource_subtype,duplicate_of,duplicate_of.created_by,duplicate_of.name,duplicate_of.resource_subtype,duplicated_from,duplicated_from.created_by,duplicated_from.name,duplicated_from.resource_subtype,follower,follower.name,hearted,hearts,hearts.user,hearts.user.name,html_text,is_editable,is_edited,is_pinned,liked,likes,likes.user,likes.user.name,new_approval_status,new_date_value,new_dates,new_dates.due_at,new_dates.due_on,new_dates.start_on,new_enum_value,new_enum_value.color,new_enum_value.enabled,new_enum_value.name,new_multi_enum_values,new_multi_enum_values.color,new_multi_enum_values.enabled,new_multi_enum_values.name,new_name,new_number_value,new_people_value,new_people_value.name,new_resource_subtype,new_section,new_section.name,new_text_value,num_hearts,num_likes,offset,old_approval_status,old_date_value,old_dates,old_dates.due_at,old_dates.due_on,old_dates.start_on,old_enum_value,old_enum_value.color,old_enum_value.enabled,old_enum_value.name,old_multi_enum_values,old_multi_enum_values.color,old_multi_enum_values.enabled,old_multi_enum_values.name,old_name,old_number_value,old_people_value,old_people_value.name,old_resource_subtype,old_section,old_section.name,old_text_value,path,previews,previews.fallback,previews.footer,previews.header,previews.header_link,previews.html_text,previews.text,previews.title,previews.title_link,project,project.name,project.resource_subtype,reaction_summary,reaction_summary.count,reaction_summary.emoji_base,reaction_summary.reacted,reaction_summary.variant,resource_subtype,source,sticker_name,story,story.anchor_gid,story.comment_gid,story.created_at,story.created_by,story.created_by.name,story.resource_subtype,story.text,tag,tag.name,target,target.created_by,target.name,target.resource_subtype,task,task.created_by,task.name,task.resource_subtype,text,type,uri\"\n};\nstoriesApiInstance.getStoriesForGoal(goal_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nstories_api_instance = asana.StoriesApi(api_client)\ngoal_gid = \"12345\" # str | Globally unique identifier for the goal.\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    'created_after': '2012-02-22T02:06:58.158Z', # datetime | Only return stories created after this time. Applies to every story type; pair it with `resource_subtype=comment_added` to get just the comments added since a given moment. The bound is exclusive but has second granularity: it is truncated to the start of its second before filtering, so any story created within that same second is still returned. A client polling with the `created_at` of the last story it saw should expect to see that story again, and others alongside it, and should de-duplicate on `gid`. \n    'resource_subtype': \"comment_added\", # str | Only return stories of this subtype. Only `comment_added` is supported, which narrows the response to comments and excludes activity such as assignments, due date changes, and project moves. Omit to return the full activity feed. \n    'sort_ascending': False, # bool | Creation-time order: `true` (the default) is oldest first, `false` is newest first. Pair `false` with `limit` to read only the most recent stories. Ordering is applied across the parent's stories; on a parent with an extremely large activity feed the feed may be truncated before it is ordered, so pair `false` with `created_after` to bound what is considered. \n    'opt_fields': \"anchor_gid,assignee,assignee.name,comment_gid,created_at,created_by,created_by.name,custom_field,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_lookup_field,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.representation_type,custom_field.text_value,custom_field.type,dependency,dependency.created_by,dependency.name,dependency.resource_subtype,duplicate_of,duplicate_of.created_by,duplicate_of.name,duplicate_of.resource_subtype,duplicated_from,duplicated_from.created_by,duplicated_from.name,duplicated_from.resource_subtype,follower,follower.name,hearted,hearts,hearts.user,hearts.user.name,html_text,is_editable,is_edited,is_pinned,liked,likes,likes.user,likes.user.name,new_approval_status,new_date_value,new_dates,new_dates.due_at,new_dates.due_on,new_dates.start_on,new_enum_value,new_enum_value.color,new_enum_value.enabled,new_enum_value.name,new_multi_enum_values,new_multi_enum_values.color,new_multi_enum_values.enabled,new_multi_enum_values.name,new_name,new_number_value,new_people_value,new_people_value.name,new_resource_subtype,new_section,new_section.name,new_text_value,num_hearts,num_likes,offset,old_approval_status,old_date_value,old_dates,old_dates.due_at,old_dates.due_on,old_dates.start_on,old_enum_value,old_enum_value.color,old_enum_value.enabled,old_enum_value.name,old_multi_enum_values,old_multi_enum_values.color,old_multi_enum_values.enabled,old_multi_enum_values.name,old_name,old_number_value,old_people_value,old_people_value.name,old_resource_subtype,old_section,old_section.name,old_text_value,path,previews,previews.fallback,previews.footer,previews.header,previews.header_link,previews.html_text,previews.text,previews.title,previews.title_link,project,project.name,project.resource_subtype,reaction_summary,reaction_summary.count,reaction_summary.emoji_base,reaction_summary.reacted,reaction_summary.variant,resource_subtype,source,sticker_name,story,story.anchor_gid,story.comment_gid,story.created_at,story.created_by,story.created_by.name,story.resource_subtype,story.text,tag,tag.name,target,target.created_by,target.name,target.resource_subtype,task,task.created_by,task.name,task.resource_subtype,text,type,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get stories from a goal\n    api_response = stories_api_instance.get_stories_for_goal(goal_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling StoriesApi->get_stories_for_goal: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/goal_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>stories:write</code>\n\nAdds a story to a goal. This endpoint currently only allows for comment\nstories to be created. The comment will be authored by the currently\nauthenticated user, and timestamped when the server receives the request.\n\nReturns the full record for the new story added to the goal.",
        "operationId": "createStoryForGoal",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "anchor_gid",
              "assignee",
              "assignee.name",
              "comment_gid",
              "created_at",
              "created_by",
              "created_by.name",
              "custom_field",
              "custom_field.date_value",
              "custom_field.date_value.date",
              "custom_field.date_value.date_time",
              "custom_field.display_value",
              "custom_field.enabled",
              "custom_field.enum_options",
              "custom_field.enum_options.color",
              "custom_field.enum_options.enabled",
              "custom_field.enum_options.name",
              "custom_field.enum_value",
              "custom_field.enum_value.color",
              "custom_field.enum_value.enabled",
              "custom_field.enum_value.name",
              "custom_field.id_prefix",
              "custom_field.input_restrictions",
              "custom_field.is_formula_field",
              "custom_field.is_lookup_field",
              "custom_field.multi_enum_values",
              "custom_field.multi_enum_values.color",
              "custom_field.multi_enum_values.enabled",
              "custom_field.multi_enum_values.name",
              "custom_field.name",
              "custom_field.number_value",
              "custom_field.representation_type",
              "custom_field.text_value",
              "custom_field.type",
              "dependency",
              "dependency.created_by",
              "dependency.name",
              "dependency.resource_subtype",
              "duplicate_of",
              "duplicate_of.created_by",
              "duplicate_of.name",
              "duplicate_of.resource_subtype",
              "duplicated_from",
              "duplicated_from.created_by",
              "duplicated_from.name",
              "duplicated_from.resource_subtype",
              "follower",
              "follower.name",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_text",
              "is_editable",
              "is_edited",
              "is_pinned",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "new_approval_status",
              "new_date_value",
              "new_dates",
              "new_dates.due_at",
              "new_dates.due_on",
              "new_dates.start_on",
              "new_enum_value",
              "new_enum_value.color",
              "new_enum_value.enabled",
              "new_enum_value.name",
              "new_multi_enum_values",
              "new_multi_enum_values.color",
              "new_multi_enum_values.enabled",
              "new_multi_enum_values.name",
              "new_name",
              "new_number_value",
              "new_people_value",
              "new_people_value.name",
              "new_resource_subtype",
              "new_section",
              "new_section.name",
              "new_text_value",
              "num_hearts",
              "num_likes",
              "old_approval_status",
              "old_date_value",
              "old_dates",
              "old_dates.due_at",
              "old_dates.due_on",
              "old_dates.start_on",
              "old_enum_value",
              "old_enum_value.color",
              "old_enum_value.enabled",
              "old_enum_value.name",
              "old_multi_enum_values",
              "old_multi_enum_values.color",
              "old_multi_enum_values.enabled",
              "old_multi_enum_values.name",
              "old_name",
              "old_number_value",
              "old_people_value",
              "old_people_value.name",
              "old_resource_subtype",
              "old_section",
              "old_section.name",
              "old_text_value",
              "previews",
              "previews.fallback",
              "previews.footer",
              "previews.header",
              "previews.header_link",
              "previews.html_text",
              "previews.text",
              "previews.title",
              "previews.title_link",
              "project",
              "project.name",
              "project.resource_subtype",
              "reaction_summary",
              "reaction_summary.count",
              "reaction_summary.emoji_base",
              "reaction_summary.reacted",
              "reaction_summary.variant",
              "resource_subtype",
              "source",
              "sticker_name",
              "story",
              "story.anchor_gid",
              "story.comment_gid",
              "story.created_at",
              "story.created_by",
              "story.created_by.name",
              "story.resource_subtype",
              "story.text",
              "tag",
              "tag.name",
              "target",
              "target.created_by",
              "target.name",
              "target.resource_subtype",
              "task",
              "task.created_by",
              "task.name",
              "task.resource_subtype",
              "text",
              "type"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "anchor_gid",
                  "assignee",
                  "assignee.name",
                  "comment_gid",
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "custom_field",
                  "custom_field.date_value",
                  "custom_field.date_value.date",
                  "custom_field.date_value.date_time",
                  "custom_field.display_value",
                  "custom_field.enabled",
                  "custom_field.enum_options",
                  "custom_field.enum_options.color",
                  "custom_field.enum_options.enabled",
                  "custom_field.enum_options.name",
                  "custom_field.enum_value",
                  "custom_field.enum_value.color",
                  "custom_field.enum_value.enabled",
                  "custom_field.enum_value.name",
                  "custom_field.id_prefix",
                  "custom_field.input_restrictions",
                  "custom_field.is_formula_field",
                  "custom_field.is_lookup_field",
                  "custom_field.multi_enum_values",
                  "custom_field.multi_enum_values.color",
                  "custom_field.multi_enum_values.enabled",
                  "custom_field.multi_enum_values.name",
                  "custom_field.name",
                  "custom_field.number_value",
                  "custom_field.representation_type",
                  "custom_field.text_value",
                  "custom_field.type",
                  "dependency",
                  "dependency.created_by",
                  "dependency.name",
                  "dependency.resource_subtype",
                  "duplicate_of",
                  "duplicate_of.created_by",
                  "duplicate_of.name",
                  "duplicate_of.resource_subtype",
                  "duplicated_from",
                  "duplicated_from.created_by",
                  "duplicated_from.name",
                  "duplicated_from.resource_subtype",
                  "follower",
                  "follower.name",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_text",
                  "is_editable",
                  "is_edited",
                  "is_pinned",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "new_approval_status",
                  "new_date_value",
                  "new_dates",
                  "new_dates.due_at",
                  "new_dates.due_on",
                  "new_dates.start_on",
                  "new_enum_value",
                  "new_enum_value.color",
                  "new_enum_value.enabled",
                  "new_enum_value.name",
                  "new_multi_enum_values",
                  "new_multi_enum_values.color",
                  "new_multi_enum_values.enabled",
                  "new_multi_enum_values.name",
                  "new_name",
                  "new_number_value",
                  "new_people_value",
                  "new_people_value.name",
                  "new_resource_subtype",
                  "new_section",
                  "new_section.name",
                  "new_text_value",
                  "num_hearts",
                  "num_likes",
                  "old_approval_status",
                  "old_date_value",
                  "old_dates",
                  "old_dates.due_at",
                  "old_dates.due_on",
                  "old_dates.start_on",
                  "old_enum_value",
                  "old_enum_value.color",
                  "old_enum_value.enabled",
                  "old_enum_value.name",
                  "old_multi_enum_values",
                  "old_multi_enum_values.color",
                  "old_multi_enum_values.enabled",
                  "old_multi_enum_values.name",
                  "old_name",
                  "old_number_value",
                  "old_people_value",
                  "old_people_value.name",
                  "old_resource_subtype",
                  "old_section",
                  "old_section.name",
                  "old_text_value",
                  "previews",
                  "previews.fallback",
                  "previews.footer",
                  "previews.header",
                  "previews.header_link",
                  "previews.html_text",
                  "previews.text",
                  "previews.title",
                  "previews.title_link",
                  "project",
                  "project.name",
                  "project.resource_subtype",
                  "reaction_summary",
                  "reaction_summary.count",
                  "reaction_summary.emoji_base",
                  "reaction_summary.reacted",
                  "reaction_summary.variant",
                  "resource_subtype",
                  "source",
                  "sticker_name",
                  "story",
                  "story.anchor_gid",
                  "story.comment_gid",
                  "story.created_at",
                  "story.created_by",
                  "story.created_by.name",
                  "story.resource_subtype",
                  "story.text",
                  "tag",
                  "tag.name",
                  "target",
                  "target.created_by",
                  "target.name",
                  "target.resource_subtype",
                  "task",
                  "task.created_by",
                  "task.name",
                  "task.resource_subtype",
                  "text",
                  "type"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/StoryRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The story to create.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/StoryResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__StoryResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created a new story."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "stories:write"
            ]
          }
        ],
        "summary": "Create a story on a goal",
        "tags": [
          "Stories"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1goals~1{goal_gid}~1stories/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet storiesApiInstance = new Asana.StoriesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The story to create.\nlet goal_gid = \"12345\"; // String | Globally unique identifier for the goal.\nlet opts = { \n    'opt_fields': \"anchor_gid,assignee,assignee.name,comment_gid,created_at,created_by,created_by.name,custom_field,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_lookup_field,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.representation_type,custom_field.text_value,custom_field.type,dependency,dependency.created_by,dependency.name,dependency.resource_subtype,duplicate_of,duplicate_of.created_by,duplicate_of.name,duplicate_of.resource_subtype,duplicated_from,duplicated_from.created_by,duplicated_from.name,duplicated_from.resource_subtype,follower,follower.name,hearted,hearts,hearts.user,hearts.user.name,html_text,is_editable,is_edited,is_pinned,liked,likes,likes.user,likes.user.name,new_approval_status,new_date_value,new_dates,new_dates.due_at,new_dates.due_on,new_dates.start_on,new_enum_value,new_enum_value.color,new_enum_value.enabled,new_enum_value.name,new_multi_enum_values,new_multi_enum_values.color,new_multi_enum_values.enabled,new_multi_enum_values.name,new_name,new_number_value,new_people_value,new_people_value.name,new_resource_subtype,new_section,new_section.name,new_text_value,num_hearts,num_likes,old_approval_status,old_date_value,old_dates,old_dates.due_at,old_dates.due_on,old_dates.start_on,old_enum_value,old_enum_value.color,old_enum_value.enabled,old_enum_value.name,old_multi_enum_values,old_multi_enum_values.color,old_multi_enum_values.enabled,old_multi_enum_values.name,old_name,old_number_value,old_people_value,old_people_value.name,old_resource_subtype,old_section,old_section.name,old_text_value,previews,previews.fallback,previews.footer,previews.header,previews.header_link,previews.html_text,previews.text,previews.title,previews.title_link,project,project.name,project.resource_subtype,reaction_summary,reaction_summary.count,reaction_summary.emoji_base,reaction_summary.reacted,reaction_summary.variant,resource_subtype,source,sticker_name,story,story.anchor_gid,story.comment_gid,story.created_at,story.created_by,story.created_by.name,story.resource_subtype,story.text,tag,tag.name,target,target.created_by,target.name,target.resource_subtype,task,task.created_by,task.name,task.resource_subtype,text,type\"\n};\nstoriesApiInstance.createStoryForGoal(body, goal_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nstories_api_instance = asana.StoriesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The story to create.\ngoal_gid = \"12345\" # str | Globally unique identifier for the goal.\nopts = {\n    'opt_fields': \"anchor_gid,assignee,assignee.name,comment_gid,created_at,created_by,created_by.name,custom_field,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_lookup_field,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.representation_type,custom_field.text_value,custom_field.type,dependency,dependency.created_by,dependency.name,dependency.resource_subtype,duplicate_of,duplicate_of.created_by,duplicate_of.name,duplicate_of.resource_subtype,duplicated_from,duplicated_from.created_by,duplicated_from.name,duplicated_from.resource_subtype,follower,follower.name,hearted,hearts,hearts.user,hearts.user.name,html_text,is_editable,is_edited,is_pinned,liked,likes,likes.user,likes.user.name,new_approval_status,new_date_value,new_dates,new_dates.due_at,new_dates.due_on,new_dates.start_on,new_enum_value,new_enum_value.color,new_enum_value.enabled,new_enum_value.name,new_multi_enum_values,new_multi_enum_values.color,new_multi_enum_values.enabled,new_multi_enum_values.name,new_name,new_number_value,new_people_value,new_people_value.name,new_resource_subtype,new_section,new_section.name,new_text_value,num_hearts,num_likes,old_approval_status,old_date_value,old_dates,old_dates.due_at,old_dates.due_on,old_dates.start_on,old_enum_value,old_enum_value.color,old_enum_value.enabled,old_enum_value.name,old_multi_enum_values,old_multi_enum_values.color,old_multi_enum_values.enabled,old_multi_enum_values.name,old_name,old_number_value,old_people_value,old_people_value.name,old_resource_subtype,old_section,old_section.name,old_text_value,previews,previews.fallback,previews.footer,previews.header,previews.header_link,previews.html_text,previews.text,previews.title,previews.title_link,project,project.name,project.resource_subtype,reaction_summary,reaction_summary.count,reaction_summary.emoji_base,reaction_summary.reacted,reaction_summary.variant,resource_subtype,source,sticker_name,story,story.anchor_gid,story.comment_gid,story.created_at,story.created_by,story.created_by.name,story.resource_subtype,story.text,tag,tag.name,target,target.created_by,target.name,target.resource_subtype,task,task.created_by,task.name,task.resource_subtype,text,type\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create a story on a goal\n    api_response = stories_api_instance.create_story_for_goal(body, goal_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling StoriesApi->create_story_for_goal: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/jobs/{job_gid}": {
      "get": {
        "description": "<b>Required scope: </b><code>jobs:read</code>\n\nReturns the full record for a job.",
        "operationId": "getJob",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "dates_rollup_progress",
              "dates_rollup_progress.total_tasks",
              "dates_rollup_progress.updated_tasks",
              "new_graph_export",
              "new_graph_export.completed_at",
              "new_graph_export.created_at",
              "new_graph_export.download_url",
              "new_portfolio",
              "new_portfolio.name",
              "new_portfolio.resource_subtype",
              "new_project",
              "new_project.name",
              "new_project.resource_subtype",
              "new_project_template",
              "new_project_template.name",
              "new_resource_export",
              "new_resource_export.completed_at",
              "new_resource_export.created_at",
              "new_resource_export.download_url",
              "new_task",
              "new_task.created_by",
              "new_task.name",
              "new_task.resource_subtype",
              "resource_subtype",
              "status"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "dates_rollup_progress",
                  "dates_rollup_progress.total_tasks",
                  "dates_rollup_progress.updated_tasks",
                  "new_graph_export",
                  "new_graph_export.completed_at",
                  "new_graph_export.created_at",
                  "new_graph_export.download_url",
                  "new_portfolio",
                  "new_portfolio.name",
                  "new_portfolio.resource_subtype",
                  "new_project",
                  "new_project.name",
                  "new_project.resource_subtype",
                  "new_project_template",
                  "new_project_template.name",
                  "new_resource_export",
                  "new_resource_export.completed_at",
                  "new_resource_export.created_at",
                  "new_resource_export.download_url",
                  "new_task",
                  "new_task.created_by",
                  "new_task.name",
                  "new_task.resource_subtype",
                  "resource_subtype",
                  "status"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/JobResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__JobResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved Job."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "jobs:read"
            ]
          }
        ],
        "summary": "Get a job by id",
        "tags": [
          "Jobs"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1jobs~1{job_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJob result = client.jobs.getJob(jobGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet jobsApiInstance = new Asana.JobsApi(client);\nlet job_gid = \"12345\"; // String | Globally unique identifier for the job.\nlet opts = { \n    'opt_fields': \"dates_rollup_progress,dates_rollup_progress.total_tasks,dates_rollup_progress.updated_tasks,new_graph_export,new_graph_export.completed_at,new_graph_export.created_at,new_graph_export.download_url,new_portfolio,new_portfolio.name,new_portfolio.resource_subtype,new_project,new_project.name,new_project.resource_subtype,new_project_template,new_project_template.name,new_resource_export,new_resource_export.completed_at,new_resource_export.created_at,new_resource_export.download_url,new_task,new_task.created_by,new_task.name,new_task.resource_subtype,resource_subtype,status\"\n};\njobsApiInstance.getJob(job_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.jobs.getJob(jobGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\njobs_api_instance = asana.JobsApi(api_client)\njob_gid = \"12345\" # str | Globally unique identifier for the job.\nopts = {\n    'opt_fields': \"dates_rollup_progress,dates_rollup_progress.total_tasks,dates_rollup_progress.updated_tasks,new_graph_export,new_graph_export.completed_at,new_graph_export.created_at,new_graph_export.download_url,new_portfolio,new_portfolio.name,new_portfolio.resource_subtype,new_project,new_project.name,new_project.resource_subtype,new_project_template,new_project_template.name,new_resource_export,new_resource_export.completed_at,new_resource_export.created_at,new_resource_export.download_url,new_task,new_task.created_by,new_task.name,new_task.resource_subtype,resource_subtype,status\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a job by id\n    api_response = jobs_api_instance.get_job(job_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling JobsApi->get_job: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.jobs.get_job(job_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->jobs->getJob($job_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.jobs.get_job(job_gid: 'job_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/job_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/memberships": {
      "get": {
        "description": "Returns compact `goal_membership`, `project_membership`, `portfolio_membership`, `custom_type_membership`, `custom_field_membership`, `table_membership`, or `record_membership` records. The possible types for `parent` in this request are `goal`, `project`, `portfolio`, `custom_type`, `custom_field`, `table`, or `record`. An additional member (user GID or team GID) can be passed in to filter to a specific membership.\n\nAlternatively, when `parent` is absent, you can use the `member` and `resource_subtype` parameters together to fetch all memberships of a specific type for a given member. For example, passing `member` as a team GID and `resource_subtype` as `project_membership` will return all project memberships for that team.",
        "operationId": "getMemberships",
        "parameters": [
          {
            "description": "Globally unique identifier for `goal`, `project`, `portfolio`, `custom_type`, `custom_field`, `table`, or `record`. This parameter is optional when `resource_subtype` is provided along with `member` of type `team`.",
            "example": "159874",
            "in": "query",
            "name": "parent",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Globally unique identifier for `team` or `user`. When used with `resource_subtype` and without `parent`, `member` must be of type `team`. For user-type memberships `parent` parameter is required to disambiguate the workspace from which memberships should be retrieved.",
            "example": "1061493",
            "in": "query",
            "name": "member",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The type of membership to return. Required when `parent` is absent. Currently supported value is `project_membership` (when `member` is a team GID, returns all project memberships for that team).",
            "example": "project_membership",
            "in": "query",
            "name": "resource_subtype",
            "schema": {
              "enum": [
                "project_membership"
              ],
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "offset",
              "path",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "offset",
                  "path",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/MembershipCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__MembershipResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested membership."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get multiple memberships",
        "tags": [
          "Memberships"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1memberships/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet membershipsApiInstance = new Asana.MembershipsApi(client);\nlet opts = { \n    'parent': \"159874\", \n    'member': \"1061493\", \n    'resource_subtype': \"project_membership\", \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"offset,path,uri\"\n};\nmembershipsApiInstance.getMemberships(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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.memberships.getMemberships({param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nmemberships_api_instance = asana.MembershipsApi(api_client)\nopts = {\n    'parent': \"159874\", # str | Globally unique identifier for `goal`, `project`, `portfolio`, `custom_type`, `custom_field`, `table`, or `record`. This parameter is optional when `resource_subtype` is provided along with `member` of type `team`.\n    'member': \"1061493\", # str | Globally unique identifier for `team` or `user`. When used with `resource_subtype` and without `parent`, `member` must be of type `team`. For user-type memberships `parent` parameter is required to disambiguate the workspace from which memberships should be retrieved.\n    'resource_subtype': \"project_membership\", # str | The type of membership to return. Required when `parent` is absent. Currently supported value is `project_membership` (when `member` is a team GID, returns all project memberships for that team).\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    'opt_fields': \"offset,path,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get multiple memberships\n    api_response = memberships_api_instance.get_memberships(opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling MembershipsApi->get_memberships: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.memberships.get_memberships({'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->memberships->getMemberships(array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.memberships.get_memberships(parent: '&#x27;parent_example&#x27;', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/memberships/{membership_gid}": {
      "delete": {
        "description": "A specific, existing membership for a `goal`, `project`, `portfolio`, `custom_type`, `custom_field`, `table`, or `record` can be deleted by making a `DELETE` request\non the URL for that membership.\n\nReturns an empty data record.",
        "operationId": "deleteMembership",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully deleted the requested membership."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Delete a membership",
        "tags": [
          "Memberships"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1memberships~1{membership_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet membershipsApiInstance = new Asana.MembershipsApi(client);\nlet membership_gid = \"12345\"; // String | Globally unique identifier for the membership.\n\nmembershipsApiInstance.deleteMembership(membership_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.memberships.deleteMembership(membershipGid)\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nmemberships_api_instance = asana.MembershipsApi(api_client)\nmembership_gid = \"12345\" # str | Globally unique identifier for the membership.\n\n\ntry:\n    # Delete a membership\n    api_response = memberships_api_instance.delete_membership(membership_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling MembershipsApi->delete_membership: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.memberships.delete_membership(membership_gid, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->memberships->deleteMembership($membership_gid, array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.memberships.delete_membership(membership_gid: 'membership_gid', options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "get": {
        "description": "Returns a `project_membership`, `goal_membership`, `portfolio_membership`, `custom_type_membership`, `custom_field_membership`, `table_membership`, or `record_membership` record for a membership id.",
        "operationId": "getMembership",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/MembershipResponse",
                          "type": "object"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__MembershipResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the record for a single membership."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get a membership",
        "tags": [
          "Memberships"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1memberships~1{membership_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet membershipsApiInstance = new Asana.MembershipsApi(client);\nlet membership_gid = \"12345\"; // String | Globally unique identifier for the membership.\n\nmembershipsApiInstance.getMembership(membership_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.memberships.getMembership(membershipGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nmemberships_api_instance = asana.MembershipsApi(api_client)\nmembership_gid = \"12345\" # str | Globally unique identifier for the membership.\n\n\ntry:\n    # Get a membership\n    api_response = memberships_api_instance.get_membership(membership_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling MembershipsApi->get_membership: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.memberships.get_membership(membership_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/membership_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/ooo_entries": {
      "get": {
        "description": "<b>Required scope: </b><code>ooo_entries:read</code>\n\nReturns a list of OOO entries for the specified user.",
        "operationId": "getOooEntries",
        "parameters": [
          {
            "description": "Globally unique identifier for the user to filter OOO entries by.",
            "example": "12345",
            "in": "query",
            "name": "user",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Globally unique identifier for the workspace.",
            "example": "98765",
            "in": "query",
            "name": "workspace",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "An ISO 8601 date string. Filters to OOO entries that overlap with or end after this date.",
            "example": "2025-01-01",
            "in": "query",
            "name": "start_date",
            "required": false,
            "schema": {
              "format": "date",
              "type": "string"
            }
          },
          {
            "description": "An ISO 8601 date string. Filters to OOO entries that overlap with or start before this date.",
            "example": "2025-12-31",
            "in": "query",
            "name": "end_date",
            "required": false,
            "schema": {
              "format": "date",
              "type": "string"
            }
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_by",
              "created_by.name",
              "end_date",
              "offset",
              "path",
              "start_date",
              "uri",
              "user",
              "user.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_by",
                  "created_by.name",
                  "end_date",
                  "offset",
                  "path",
                  "start_date",
                  "uri",
                  "user",
                  "user.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/OooEntryResponse"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__OooEntryResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested OOO entries."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "ooo_entries:read"
            ]
          }
        ],
        "summary": "Get OOO entries for a user",
        "tags": [
          "Ooo entries"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1ooo_entries/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet oooEntriesApiInstance = new Asana.OooEntriesApi(client);\nlet user = \"12345\"; // String | Globally unique identifier for the user to filter OOO entries by.\nlet workspace = \"98765\"; // String | Globally unique identifier for the workspace.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'start_date': \"2025-01-01\", \n    'end_date': \"2025-12-31\", \n    'opt_fields': \"created_by,created_by.name,end_date,offset,path,start_date,uri,user,user.name\"\n};\noooEntriesApiInstance.getOooEntries(user, workspace, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nooo_entries_api_instance = asana.OooEntriesApi(api_client)\nuser = \"12345\" # str | Globally unique identifier for the user to filter OOO entries by.\nworkspace = \"98765\" # str | Globally unique identifier for the workspace.\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    'start_date': '2025-01-01', # date | An ISO 8601 date string. Filters to OOO entries that overlap with or end after this date.\n    'end_date': '2025-12-31', # date | An ISO 8601 date string. Filters to OOO entries that overlap with or start before this date.\n    'opt_fields': \"created_by,created_by.name,end_date,offset,path,start_date,uri,user,user.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get OOO entries for a user\n    api_response = ooo_entries_api_instance.get_ooo_entries(user, workspace, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling OooEntriesApi->get_ooo_entries: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>ooo_entries:write</code>\n\nCreates a new OOO entry.\n\nReturns the full record of the newly created OOO entry.",
        "operationId": "createOooEntry",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_by",
              "created_by.name",
              "end_date",
              "start_date",
              "user",
              "user.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_by",
                  "created_by.name",
                  "end_date",
                  "start_date",
                  "user",
                  "user.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/OooEntryCreateRequest"
                      },
                      {
                        "required": [
                          "user",
                          "workspace",
                          "start_date",
                          "end_date"
                        ],
                        "type": "object"
                      }
                    ]
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The OOO entry to create.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/OooEntryResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__OooEntryResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created a new OOO entry."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "ooo_entries:write"
            ]
          }
        ],
        "summary": "Create an OOO entry",
        "tags": [
          "Ooo entries"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1ooo_entries/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet oooEntriesApiInstance = new Asana.OooEntriesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The OOO entry to create.\nlet opts = { \n    'opt_fields': \"created_by,created_by.name,end_date,start_date,user,user.name\"\n};\noooEntriesApiInstance.createOooEntry(body, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nooo_entries_api_instance = asana.OooEntriesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The OOO entry to create.\nopts = {\n    'opt_fields': \"created_by,created_by.name,end_date,start_date,user,user.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create an OOO entry\n    api_response = ooo_entries_api_instance.create_ooo_entry(body, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling OooEntriesApi->create_ooo_entry: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/ooo_entries/{ooo_entry_gid}": {
      "delete": {
        "description": "<b>Required scope: </b><code>ooo_entries:delete</code>\n\nA specific, existing OOO entry can be deleted by making a DELETE request on the URL for that OOO entry.\n\nReturns an empty data record.",
        "operationId": "deleteOooEntry",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully deleted the specified OOO entry."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "ooo_entries:delete"
            ]
          }
        ],
        "summary": "Delete an OOO entry",
        "tags": [
          "Ooo entries"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1ooo_entries~1{ooo_entry_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet oooEntriesApiInstance = new Asana.OooEntriesApi(client);\nlet ooo_entry_gid = \"12345\"; // String | Globally unique identifier for the OOO entry.\n\noooEntriesApiInstance.deleteOooEntry(ooo_entry_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nooo_entries_api_instance = asana.OooEntriesApi(api_client)\nooo_entry_gid = \"12345\" # str | Globally unique identifier for the OOO entry.\n\n\ntry:\n    # Delete an OOO entry\n    api_response = ooo_entries_api_instance.delete_ooo_entry(ooo_entry_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling OooEntriesApi->delete_ooo_entry: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "get": {
        "description": "<b>Required scope: </b><code>ooo_entries:read</code>\n\nReturns the complete OOO entry record for a single OOO entry.",
        "operationId": "getOooEntry",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_by",
              "created_by.name",
              "end_date",
              "start_date",
              "user",
              "user.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_by",
                  "created_by.name",
                  "end_date",
                  "start_date",
                  "user",
                  "user.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/OooEntryResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__OooEntryResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the record for a single OOO entry."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "ooo_entries:read"
            ]
          }
        ],
        "summary": "Get an OOO entry",
        "tags": [
          "Ooo entries"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1ooo_entries~1{ooo_entry_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet oooEntriesApiInstance = new Asana.OooEntriesApi(client);\nlet ooo_entry_gid = \"12345\"; // String | Globally unique identifier for the OOO entry.\nlet opts = { \n    'opt_fields': \"created_by,created_by.name,end_date,start_date,user,user.name\"\n};\noooEntriesApiInstance.getOooEntry(ooo_entry_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nooo_entries_api_instance = asana.OooEntriesApi(api_client)\nooo_entry_gid = \"12345\" # str | Globally unique identifier for the OOO entry.\nopts = {\n    'opt_fields': \"created_by,created_by.name,end_date,start_date,user,user.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get an OOO entry\n    api_response = ooo_entries_api_instance.get_ooo_entry(ooo_entry_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling OooEntriesApi->get_ooo_entry: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/ooo_entry_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "put": {
        "description": "<b>Required scope: </b><code>ooo_entries:write</code>\n\nAn existing OOO entry can be updated by making a PUT request on the URL for\nthat OOO entry. Only the fields provided in the `data` block will be updated;\nany unspecified fields will remain unchanged.\n\nReturns the complete updated OOO entry record.",
        "operationId": "updateOooEntry",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_by",
              "created_by.name",
              "end_date",
              "start_date",
              "user",
              "user.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_by",
                  "created_by.name",
                  "end_date",
                  "start_date",
                  "user",
                  "user.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/OooEntryUpdateRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The updated fields for the OOO entry.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/OooEntryResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__OooEntryResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully updated the OOO entry."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "ooo_entries:write"
            ]
          }
        ],
        "summary": "Update an OOO entry",
        "tags": [
          "Ooo entries"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1ooo_entries~1{ooo_entry_gid}/put",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet oooEntriesApiInstance = new Asana.OooEntriesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The updated fields for the OOO entry.\nlet ooo_entry_gid = \"12345\"; // String | Globally unique identifier for the OOO entry.\nlet opts = { \n    'opt_fields': \"created_by,created_by.name,end_date,start_date,user,user.name\"\n};\noooEntriesApiInstance.updateOooEntry(body, ooo_entry_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nooo_entries_api_instance = asana.OooEntriesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The updated fields for the OOO entry.\nooo_entry_gid = \"12345\" # str | Globally unique identifier for the OOO entry.\nopts = {\n    'opt_fields': \"created_by,created_by.name,end_date,start_date,user,user.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Update an OOO entry\n    api_response = ooo_entries_api_instance.update_ooo_entry(body, ooo_entry_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling OooEntriesApi->update_ooo_entry: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/organization_exports": {
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "This method creates a request to export an Organization. Asana will complete the export at some point after you create the request.",
        "operationId": "createOrganizationExport",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_at",
              "download_url",
              "organization",
              "organization.name",
              "state"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_at",
                  "download_url",
                  "organization",
                  "organization.name",
                  "state"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/OrganizationExportRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The organization to export.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/OrganizationExportResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__OrganizationExportResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created organization export request."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Create an organization export request",
        "tags": [
          "Organization exports"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1organization_exports/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nOrganizationExport result = client.organizationexports.createOrganizationExport()\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet organizationExportsApiInstance = new Asana.OrganizationExportsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The organization to export.\nlet opts = { \n    'opt_fields': \"created_at,download_url,organization,organization.name,state\"\n};\norganizationExportsApiInstance.createOrganizationExport(body, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.organizationexports.createOrganizationExport({field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\norganization_exports_api_instance = asana.OrganizationExportsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The organization to export.\nopts = {\n    'opt_fields': \"created_at,download_url,organization,organization.name,state\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create an organization export request\n    api_response = organization_exports_api_instance.create_organization_export(body, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling OrganizationExportsApi->create_organization_export: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.organization_exports.create_organization_export({'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->organizationexports->createOrganizationExport(array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.organization_exports.create_organization_export(field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/organization_exports/{organization_export_gid}": {
      "get": {
        "description": "Returns details of a previously-requested Organization export.",
        "operationId": "getOrganizationExport",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_at",
              "download_url",
              "organization",
              "organization.name",
              "state"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_at",
                  "download_url",
                  "organization",
                  "organization.name",
                  "state"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/OrganizationExportResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__OrganizationExportResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved organization export object."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get details on an org export request",
        "tags": [
          "Organization exports"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1organization_exports~1{organization_export_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nOrganizationExport result = client.organizationexports.getOrganizationExport(organizationExportGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet organizationExportsApiInstance = new Asana.OrganizationExportsApi(client);\nlet organization_export_gid = \"12345\"; // String | Globally unique identifier for the organization export.\nlet opts = { \n    'opt_fields': \"created_at,download_url,organization,organization.name,state\"\n};\norganizationExportsApiInstance.getOrganizationExport(organization_export_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.organizationexports.getOrganizationExport(organizationExportGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\norganization_exports_api_instance = asana.OrganizationExportsApi(api_client)\norganization_export_gid = \"12345\" # str | Globally unique identifier for the organization export.\nopts = {\n    'opt_fields': \"created_at,download_url,organization,organization.name,state\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get details on an org export request\n    api_response = organization_exports_api_instance.get_organization_export(organization_export_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling OrganizationExportsApi->get_organization_export: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.organization_exports.get_organization_export(organization_export_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->organizationexports->getOrganizationExport($organization_export_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.organization_exports.get_organization_export(organization_export_gid: 'organization_export_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/organization_export_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/portfolio_memberships": {
      "get": {
        "description": "Returns a list of portfolio memberships in compact representation. You must specify `portfolio`, `portfolio` and `user`, or `workspace` and `user`.",
        "operationId": "getPortfolioMemberships",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "access_level",
              "offset",
              "path",
              "portfolio",
              "portfolio.name",
              "portfolio.resource_subtype",
              "uri",
              "user",
              "user.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "access_level",
                  "offset",
                  "path",
                  "portfolio",
                  "portfolio.name",
                  "portfolio.resource_subtype",
                  "uri",
                  "user",
                  "user.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/DeprecatedPortfolioMembershipCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__DeprecatedPortfolioMembershipResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved portfolio memberships."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get multiple portfolio memberships",
        "tags": [
          "Portfolio memberships"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1portfolio_memberships/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<PortfolioMembership> result = client.portfoliomemberships.getPortfolioMemberships(user, workspace, portfolio)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet portfolioMembershipsApiInstance = new Asana.PortfolioMembershipsApi(client);\nlet opts = { \n    'portfolio': \"12345\", \n    'workspace': \"12345\", \n    'user': \"me\", \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"access_level,offset,path,portfolio,portfolio.name,portfolio.resource_subtype,uri,user,user.name\"\n};\nportfolioMembershipsApiInstance.getPortfolioMemberships(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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.portfoliomemberships.getPortfolioMemberships({param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nportfolio_memberships_api_instance = asana.PortfolioMembershipsApi(api_client)\nopts = {\n    'portfolio': \"12345\", # str | The portfolio to filter results on.\n    'workspace': \"12345\", # str | The workspace to filter results on.\n    'user': \"me\", # str | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\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    'opt_fields': \"access_level,offset,path,portfolio,portfolio.name,portfolio.resource_subtype,uri,user,user.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get multiple portfolio memberships\n    api_response = portfolio_memberships_api_instance.get_portfolio_memberships(opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling PortfolioMembershipsApi->get_portfolio_memberships: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.portfolio_memberships.get_portfolio_memberships({'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->portfoliomemberships->getPortfolioMemberships(array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.portfolio_memberships.get_portfolio_memberships(param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/portfolio_query_param"
        },
        {
          "$ref": "#/components/parameters/workspace_query_param"
        },
        {
          "$ref": "#/components/parameters/user_query_param"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/portfolio_memberships/{portfolio_membership_gid}": {
      "get": {
        "description": "Returns the complete portfolio record for a single portfolio membership.",
        "operationId": "getPortfolioMembership",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "access_level",
              "portfolio",
              "portfolio.name",
              "portfolio.resource_subtype",
              "user",
              "user.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "access_level",
                  "portfolio",
                  "portfolio.name",
                  "portfolio.resource_subtype",
                  "user",
                  "user.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/DeprecatedPortfolioMembershipResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__DeprecatedPortfolioMembershipResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested portfolio membership."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get a portfolio membership",
        "tags": [
          "Portfolio memberships"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1portfolio_memberships~1{portfolio_membership_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nPortfolioMembership result = client.portfoliomemberships.getPortfolioMembership(portfolioMembershipGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet portfolioMembershipsApiInstance = new Asana.PortfolioMembershipsApi(client);\nlet portfolio_membership_gid = \"1331\"; // String | \nlet opts = { \n    'opt_fields': \"access_level,portfolio,portfolio.name,portfolio.resource_subtype,user,user.name\"\n};\nportfolioMembershipsApiInstance.getPortfolioMembership(portfolio_membership_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.portfoliomemberships.getPortfolioMembership(portfolioMembershipGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nportfolio_memberships_api_instance = asana.PortfolioMembershipsApi(api_client)\nportfolio_membership_gid = \"1331\" # str | \nopts = {\n    'opt_fields': \"access_level,portfolio,portfolio.name,portfolio.resource_subtype,user,user.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a portfolio membership\n    api_response = portfolio_memberships_api_instance.get_portfolio_membership(portfolio_membership_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling PortfolioMembershipsApi->get_portfolio_membership: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.portfolio_memberships.get_portfolio_membership(portfolio_membership_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->portfoliomemberships->getPortfolioMembership($portfolio_membership_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.portfolio_memberships.get_portfolio_membership(portfolio_membership_gid: 'portfolio_membership_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/portfolio_membership_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/portfolios": {
      "get": {
        "description": "<b>Required scope: </b><code>portfolios:read</code>\n\nReturns a list of the portfolios in compact representation.\nThe portfolios are filtered based on the following criteria:\n- If the request is made from a regular API user (PAT or OAuth), only portfolios owned by the current API user are returned. If the `owner` parameter is omitted, it defaults to the current API user. If specified, it must identify that user; use `owner=me` to refer to the current API user.\n- If the request is made from a Service Account without the `owner` parameter, then all portfolios across the workspace are returned.\n- If the request is made from a Service Account with the `owner` parameter, then only portfolios owned by the specified user are returned.",
        "operationId": "getPortfolios",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "The workspace or organization to filter portfolios on.",
            "example": "1331",
            "in": "query",
            "name": "workspace",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The user who owns the portfolios. For regular API users (PAT or OAuth), defaults to the current API user when omitted and must identify that user when specified; use `me` to refer to the current API user. For Service Accounts, if this parameter is specified, only portfolios owned by the specified user are returned. If a Service Account omits this parameter, all portfolios across the workspace are returned.",
            "example": "14916",
            "in": "query",
            "name": "owner",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/custom_type_query_param"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "archived",
              "color",
              "created_at",
              "created_by",
              "created_by.name",
              "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.default_access_level",
              "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.html_text_value",
              "custom_field_settings.custom_field.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_global_to_workspace",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.privacy_setting",
              "custom_field_settings.custom_field.reference_value",
              "custom_field_settings.custom_field.reference_value.name",
              "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.parent.resource_subtype",
              "custom_field_settings.project",
              "custom_field_settings.project.name",
              "custom_field_settings.project.resource_subtype",
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "default_access_level",
              "due_on",
              "members",
              "members.name",
              "name",
              "offset",
              "owner",
              "owner.name",
              "path",
              "permalink_url",
              "privacy_setting",
              "project_templates",
              "project_templates.name",
              "public",
              "resource_subtype",
              "start_on",
              "uri",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "archived",
                  "color",
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "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.default_access_level",
                  "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.html_text_value",
                  "custom_field_settings.custom_field.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_global_to_workspace",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.privacy_setting",
                  "custom_field_settings.custom_field.reference_value",
                  "custom_field_settings.custom_field.reference_value.name",
                  "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.parent.resource_subtype",
                  "custom_field_settings.project",
                  "custom_field_settings.project.name",
                  "custom_field_settings.project.resource_subtype",
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "default_access_level",
                  "due_on",
                  "members",
                  "members.name",
                  "name",
                  "offset",
                  "owner",
                  "owner.name",
                  "path",
                  "permalink_url",
                  "privacy_setting",
                  "project_templates",
                  "project_templates.name",
                  "public",
                  "resource_subtype",
                  "start_on",
                  "uri",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/PortfolioCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__PortfolioResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved portfolios."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "portfolios:read"
            ]
          }
        ],
        "summary": "Get multiple portfolios",
        "tags": [
          "Portfolios"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1portfolios/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Portfolio> result = client.portfolios.getPortfolios(owner, workspace)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet portfoliosApiInstance = new Asana.PortfoliosApi(client);\nlet workspace = \"1331\"; // String | The workspace or organization to filter portfolios on.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'owner': \"14916\", \n    'custom_type': \"12345\", \n    'opt_fields': \"archived,color,created_at,created_by,created_by.name,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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,default_access_level,due_on,members,members.name,name,offset,owner,owner.name,path,permalink_url,privacy_setting,project_templates,project_templates.name,public,resource_subtype,start_on,uri,workspace,workspace.name\"\n};\nportfoliosApiInstance.getPortfolios(workspace, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.portfolios.getPortfolios({param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nportfolios_api_instance = asana.PortfoliosApi(api_client)\nworkspace = \"1331\" # str | The workspace or organization to filter portfolios on.\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    'owner': \"14916\", # str | The user who owns the portfolios. For regular API users (PAT or OAuth), defaults to the current API user when omitted and must identify that user when specified; use `me` to refer to the current API user. For Service Accounts, if this parameter is specified, only portfolios owned by the specified user are returned. If a Service Account omits this parameter, all portfolios across the workspace are returned.\n    'custom_type': \"12345\", # str | Filter results by custom type. Provide a custom type GID to return only objects of that custom type (an unknown GID returns `400`). Provide an empty string to return only objects with no custom type assigned. If this parameter is omitted, results are not filtered by custom type.\n    'opt_fields': \"archived,color,created_at,created_by,created_by.name,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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,default_access_level,due_on,members,members.name,name,offset,owner,owner.name,path,permalink_url,privacy_setting,project_templates,project_templates.name,public,resource_subtype,start_on,uri,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get multiple portfolios\n    api_response = portfolios_api_instance.get_portfolios(workspace, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling PortfoliosApi->get_portfolios: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.portfolios.get_portfolios({'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->portfolios->getPortfolios(array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.portfolios.get_portfolios(workspace: '&#x27;workspace_example&#x27;', owner: '&#x27;owner_example&#x27;', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/portfolios/{portfolio_gid}": {
      "delete": {
        "description": "An existing portfolio can be deleted by making a DELETE request on\nthe URL for that portfolio.\n\nReturns an empty data record.",
        "operationId": "deletePortfolio",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully deleted the specified portfolio."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Delete a portfolio",
        "tags": [
          "Portfolios"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1portfolios~1{portfolio_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.portfolios.deletePortfolio(portfolioGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet portfoliosApiInstance = new Asana.PortfoliosApi(client);\nlet portfolio_gid = \"12345\"; // String | Globally unique identifier for the portfolio.\n\nportfoliosApiInstance.deletePortfolio(portfolio_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.portfolios.deletePortfolio(portfolioGid)\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nportfolios_api_instance = asana.PortfoliosApi(api_client)\nportfolio_gid = \"12345\" # str | Globally unique identifier for the portfolio.\n\n\ntry:\n    # Delete a portfolio\n    api_response = portfolios_api_instance.delete_portfolio(portfolio_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling PortfoliosApi->delete_portfolio: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.portfolios.delete_portfolio(portfolio_gid, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->portfolios->deletePortfolio($portfolio_gid, array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.portfolios.delete_portfolio(portfolio_gid: 'portfolio_gid', options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "get": {
        "description": "<b>Required scope: </b><code>portfolios:read</code>\n\n<table>\n  <tr>\n    <th>Field</th>\n    <th>Required Scope</th>\n  </tr>\n  <tr>\n    <td><code>custom_type</code></td>\n    <td><code>custom_types:read</code></td>\n  </tr>\n</table>\n\nReturns the complete portfolio record for a single portfolio.",
        "operationId": "getPortfolio",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "archived",
              "color",
              "created_at",
              "created_by",
              "created_by.name",
              "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.default_access_level",
              "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.html_text_value",
              "custom_field_settings.custom_field.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_global_to_workspace",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.privacy_setting",
              "custom_field_settings.custom_field.reference_value",
              "custom_field_settings.custom_field.reference_value.name",
              "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.parent.resource_subtype",
              "custom_field_settings.project",
              "custom_field_settings.project.name",
              "custom_field_settings.project.resource_subtype",
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "default_access_level",
              "due_on",
              "members",
              "members.name",
              "name",
              "owner",
              "owner.name",
              "permalink_url",
              "privacy_setting",
              "project_templates",
              "project_templates.name",
              "public",
              "resource_subtype",
              "start_on",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "archived",
                  "color",
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "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.default_access_level",
                  "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.html_text_value",
                  "custom_field_settings.custom_field.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_global_to_workspace",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.privacy_setting",
                  "custom_field_settings.custom_field.reference_value",
                  "custom_field_settings.custom_field.reference_value.name",
                  "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.parent.resource_subtype",
                  "custom_field_settings.project",
                  "custom_field_settings.project.name",
                  "custom_field_settings.project.resource_subtype",
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "default_access_level",
                  "due_on",
                  "members",
                  "members.name",
                  "name",
                  "owner",
                  "owner.name",
                  "permalink_url",
                  "privacy_setting",
                  "project_templates",
                  "project_templates.name",
                  "public",
                  "resource_subtype",
                  "start_on",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/PortfolioResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__PortfolioResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested portfolio."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "portfolios:read"
            ]
          }
        ],
        "summary": "Get a portfolio",
        "tags": [
          "Portfolios"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1portfolios~1{portfolio_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nPortfolio result = client.portfolios.getPortfolio(portfolioGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet portfoliosApiInstance = new Asana.PortfoliosApi(client);\nlet portfolio_gid = \"12345\"; // String | Globally unique identifier for the portfolio.\nlet opts = { \n    'opt_fields': \"archived,color,created_at,created_by,created_by.name,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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,default_access_level,due_on,members,members.name,name,owner,owner.name,permalink_url,privacy_setting,project_templates,project_templates.name,public,resource_subtype,start_on,workspace,workspace.name\"\n};\nportfoliosApiInstance.getPortfolio(portfolio_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.portfolios.getPortfolio(portfolioGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nportfolios_api_instance = asana.PortfoliosApi(api_client)\nportfolio_gid = \"12345\" # str | Globally unique identifier for the portfolio.\nopts = {\n    'opt_fields': \"archived,color,created_at,created_by,created_by.name,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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,default_access_level,due_on,members,members.name,name,owner,owner.name,permalink_url,privacy_setting,project_templates,project_templates.name,public,resource_subtype,start_on,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a portfolio\n    api_response = portfolios_api_instance.get_portfolio(portfolio_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling PortfoliosApi->get_portfolio: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.portfolios.get_portfolio(portfolio_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->portfolios->getPortfolio($portfolio_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.portfolios.get_portfolio(portfolio_gid: 'portfolio_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/portfolio_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/portfolios/{portfolio_gid}/addCustomFieldSetting": {
      "parameters": [
        {
          "$ref": "#/components/parameters/portfolio_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/portfolios/{portfolio_gid}/addItem": {
      "parameters": [
        {
          "$ref": "#/components/parameters/portfolio_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>portfolios:write</code>\n\nAdd an item to a portfolio.\nReturns an empty data block.",
        "operationId": "addItemForPortfolio",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/PortfolioAddItemRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Information about the item being inserted.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully added the item to the portfolio."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "portfolios:write"
            ]
          }
        ],
        "summary": "Add a portfolio item",
        "tags": [
          "Portfolios"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1portfolios~1{portfolio_gid}~1addItem/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.portfolios.addItemForPortfolio(portfolioGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet portfoliosApiInstance = new Asana.PortfoliosApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | Information about the item being inserted.\nlet portfolio_gid = \"12345\"; // String | Globally unique identifier for the portfolio.\n\nportfoliosApiInstance.addItemForPortfolio(body, portfolio_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.portfolios.addItemForPortfolio(portfolioGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nportfolios_api_instance = asana.PortfoliosApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | Information about the item being inserted.\nportfolio_gid = \"12345\" # str | Globally unique identifier for the portfolio.\n\n\ntry:\n    # Add a portfolio item\n    api_response = portfolios_api_instance.add_item_for_portfolio(body, portfolio_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling PortfoliosApi->add_item_for_portfolio: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.portfolios.add_item_for_portfolio(portfolio_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->portfolios->addItemForPortfolio($portfolio_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.portfolios.add_item_for_portfolio(portfolio_gid: 'portfolio_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/portfolios/{portfolio_gid}/addMembers": {
      "parameters": [
        {
          "$ref": "#/components/parameters/portfolio_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/portfolios/{portfolio_gid}/custom_field_settings": {
      "get": {
        "description": "<b>Required scope: </b><code>portfolios:read</code>\n\nReturns a list of all of the custom fields settings on a portfolio, in compact form.",
        "operationId": "getCustomFieldSettingsForPortfolio",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "custom_field",
              "custom_field.asana_created_field",
              "custom_field.created_by",
              "custom_field.created_by.name",
              "custom_field.currency_code",
              "custom_field.custom_label",
              "custom_field.custom_label_position",
              "custom_field.date_value",
              "custom_field.date_value.date",
              "custom_field.date_value.date_time",
              "custom_field.default_access_level",
              "custom_field.description",
              "custom_field.display_value",
              "custom_field.enabled",
              "custom_field.enum_options",
              "custom_field.enum_options.color",
              "custom_field.enum_options.enabled",
              "custom_field.enum_options.name",
              "custom_field.enum_value",
              "custom_field.enum_value.color",
              "custom_field.enum_value.enabled",
              "custom_field.enum_value.name",
              "custom_field.format",
              "custom_field.has_notifications_enabled",
              "custom_field.html_text_value",
              "custom_field.id_prefix",
              "custom_field.input_restrictions",
              "custom_field.is_formula_field",
              "custom_field.is_global_to_workspace",
              "custom_field.is_lookup_field",
              "custom_field.is_value_read_only",
              "custom_field.multi_enum_values",
              "custom_field.multi_enum_values.color",
              "custom_field.multi_enum_values.enabled",
              "custom_field.multi_enum_values.name",
              "custom_field.name",
              "custom_field.number_value",
              "custom_field.people_value",
              "custom_field.people_value.name",
              "custom_field.precision",
              "custom_field.privacy_setting",
              "custom_field.reference_value",
              "custom_field.reference_value.name",
              "custom_field.representation_type",
              "custom_field.resource_subtype",
              "custom_field.text_value",
              "custom_field.type",
              "is_important",
              "offset",
              "parent",
              "parent.name",
              "parent.resource_subtype",
              "path",
              "project",
              "project.name",
              "project.resource_subtype",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "custom_field",
                  "custom_field.asana_created_field",
                  "custom_field.created_by",
                  "custom_field.created_by.name",
                  "custom_field.currency_code",
                  "custom_field.custom_label",
                  "custom_field.custom_label_position",
                  "custom_field.date_value",
                  "custom_field.date_value.date",
                  "custom_field.date_value.date_time",
                  "custom_field.default_access_level",
                  "custom_field.description",
                  "custom_field.display_value",
                  "custom_field.enabled",
                  "custom_field.enum_options",
                  "custom_field.enum_options.color",
                  "custom_field.enum_options.enabled",
                  "custom_field.enum_options.name",
                  "custom_field.enum_value",
                  "custom_field.enum_value.color",
                  "custom_field.enum_value.enabled",
                  "custom_field.enum_value.name",
                  "custom_field.format",
                  "custom_field.has_notifications_enabled",
                  "custom_field.html_text_value",
                  "custom_field.id_prefix",
                  "custom_field.input_restrictions",
                  "custom_field.is_formula_field",
                  "custom_field.is_global_to_workspace",
                  "custom_field.is_lookup_field",
                  "custom_field.is_value_read_only",
                  "custom_field.multi_enum_values",
                  "custom_field.multi_enum_values.color",
                  "custom_field.multi_enum_values.enabled",
                  "custom_field.multi_enum_values.name",
                  "custom_field.name",
                  "custom_field.number_value",
                  "custom_field.people_value",
                  "custom_field.people_value.name",
                  "custom_field.precision",
                  "custom_field.privacy_setting",
                  "custom_field.reference_value",
                  "custom_field.reference_value.name",
                  "custom_field.representation_type",
                  "custom_field.resource_subtype",
                  "custom_field.text_value",
                  "custom_field.type",
                  "is_important",
                  "offset",
                  "parent",
                  "parent.name",
                  "parent.resource_subtype",
                  "path",
                  "project",
                  "project.name",
                  "project.resource_subtype",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/CustomFieldSettingResponse"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__CustomFieldSettingResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved custom field settings objects for a portfolio."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "portfolios:read"
            ]
          }
        ],
        "summary": "Get a portfolio's custom fields",
        "tags": [
          "Custom field settings"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1portfolios~1{portfolio_gid}~1custom_field_settings/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<CustomFieldSetting> result = client.customfieldsettings.getCustomFieldSettingsForPortfolio(portfolioGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet customFieldSettingsApiInstance = new Asana.CustomFieldSettingsApi(client);\nlet portfolio_gid = \"12345\"; // String | Globally unique identifier for the portfolio.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"custom_field,custom_field.asana_created_field,custom_field.created_by,custom_field.created_by.name,custom_field.currency_code,custom_field.custom_label,custom_field.custom_label_position,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.default_access_level,custom_field.description,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.format,custom_field.has_notifications_enabled,custom_field.html_text_value,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_global_to_workspace,custom_field.is_lookup_field,custom_field.is_value_read_only,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.people_value,custom_field.people_value.name,custom_field.precision,custom_field.privacy_setting,custom_field.reference_value,custom_field.reference_value.name,custom_field.representation_type,custom_field.resource_subtype,custom_field.text_value,custom_field.type,is_important,offset,parent,parent.name,parent.resource_subtype,path,project,project.name,project.resource_subtype,uri\"\n};\ncustomFieldSettingsApiInstance.getCustomFieldSettingsForPortfolio(portfolio_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.customfieldsettings.getCustomFieldSettingsForPortfolio(portfolioGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ncustom_field_settings_api_instance = asana.CustomFieldSettingsApi(api_client)\nportfolio_gid = \"12345\" # str | Globally unique identifier for the portfolio.\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    'opt_fields': \"custom_field,custom_field.asana_created_field,custom_field.created_by,custom_field.created_by.name,custom_field.currency_code,custom_field.custom_label,custom_field.custom_label_position,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.default_access_level,custom_field.description,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.format,custom_field.has_notifications_enabled,custom_field.html_text_value,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_global_to_workspace,custom_field.is_lookup_field,custom_field.is_value_read_only,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.people_value,custom_field.people_value.name,custom_field.precision,custom_field.privacy_setting,custom_field.reference_value,custom_field.reference_value.name,custom_field.representation_type,custom_field.resource_subtype,custom_field.text_value,custom_field.type,is_important,offset,parent,parent.name,parent.resource_subtype,path,project,project.name,project.resource_subtype,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a portfolio's custom fields\n    api_response = custom_field_settings_api_instance.get_custom_field_settings_for_portfolio(portfolio_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling CustomFieldSettingsApi->get_custom_field_settings_for_portfolio: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.custom_field_settings.get_custom_field_settings_for_portfolio(portfolio_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->customfieldsettings->getCustomFieldSettingsForPortfolio($portfolio_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.custom_field_settings.get_custom_field_settings_for_portfolio(portfolio_gid: 'portfolio_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/portfolio_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/portfolios/{portfolio_gid}/duplicate": {
      "parameters": [
        {
          "$ref": "#/components/parameters/portfolio_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/portfolios/{portfolio_gid}/items": {
      "get": {
        "description": "<b>Required scope: </b><code>portfolios:read</code>\n\nGet a list of the items in compact form in a portfolio.",
        "operationId": "getItemsForPortfolio",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "offset",
              "path",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "offset",
                  "path",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/PortfolioItemCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__PortfolioItemCompactArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested portfolio's items."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "portfolios:read"
            ]
          }
        ],
        "summary": "Get portfolio items",
        "tags": [
          "Portfolios"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1portfolios~1{portfolio_gid}~1items/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Project> result = client.portfolios.getItemsForPortfolio(portfolioGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet portfoliosApiInstance = new Asana.PortfoliosApi(client);\nlet portfolio_gid = \"12345\"; // String | Globally unique identifier for the portfolio.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"offset,path,uri\"\n};\nportfoliosApiInstance.getItemsForPortfolio(portfolio_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.portfolios.getItemsForPortfolio(portfolioGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nportfolios_api_instance = asana.PortfoliosApi(api_client)\nportfolio_gid = \"12345\" # str | Globally unique identifier for the portfolio.\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    'opt_fields': \"offset,path,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get portfolio items\n    api_response = portfolios_api_instance.get_items_for_portfolio(portfolio_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling PortfoliosApi->get_items_for_portfolio: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.portfolios.get_items_for_portfolio(portfolio_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->portfolios->getItemsForPortfolio($portfolio_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.portfolios.get_items_for_portfolio(portfolio_gid: 'portfolio_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/portfolio_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/portfolios/{portfolio_gid}/portfolio_memberships": {
      "get": {
        "description": "Returns the compact portfolio membership records for the portfolio.",
        "operationId": "getPortfolioMembershipsForPortfolio",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "access_level",
              "offset",
              "path",
              "portfolio",
              "portfolio.name",
              "portfolio.resource_subtype",
              "uri",
              "user",
              "user.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "access_level",
                  "offset",
                  "path",
                  "portfolio",
                  "portfolio.name",
                  "portfolio.resource_subtype",
                  "uri",
                  "user",
                  "user.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/DeprecatedPortfolioMembershipCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__DeprecatedPortfolioMembershipResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested portfolio's memberships."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get memberships from a portfolio",
        "tags": [
          "Portfolio memberships"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1portfolios~1{portfolio_gid}~1portfolio_memberships/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<PortfolioMembership> result = client.portfoliomemberships.getPortfolioMembershipsForPortfolio(portfolioGid, user)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet portfolioMembershipsApiInstance = new Asana.PortfolioMembershipsApi(client);\nlet portfolio_gid = \"12345\"; // String | Globally unique identifier for the portfolio.\nlet opts = { \n    'user': \"me\", \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"access_level,offset,path,portfolio,portfolio.name,portfolio.resource_subtype,uri,user,user.name\"\n};\nportfolioMembershipsApiInstance.getPortfolioMembershipsForPortfolio(portfolio_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.portfoliomemberships.getPortfolioMembershipsForPortfolio(portfolioGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nportfolio_memberships_api_instance = asana.PortfolioMembershipsApi(api_client)\nportfolio_gid = \"12345\" # str | Globally unique identifier for the portfolio.\nopts = {\n    'user': \"me\", # str | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\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    'opt_fields': \"access_level,offset,path,portfolio,portfolio.name,portfolio.resource_subtype,uri,user,user.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get memberships from a portfolio\n    api_response = portfolio_memberships_api_instance.get_portfolio_memberships_for_portfolio(portfolio_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling PortfolioMembershipsApi->get_portfolio_memberships_for_portfolio: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.portfolio_memberships.get_portfolio_memberships_for_portfolio(portfolio_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->portfoliomemberships->getPortfolioMembershipsForPortfolio($portfolio_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.portfolio_memberships.get_portfolio_memberships_for_portfolio(portfolio_gid: 'portfolio_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/portfolio_path_gid"
        },
        {
          "$ref": "#/components/parameters/user_query_param"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/portfolios/{portfolio_gid}/project_portfolio_settings": {
      "get": {
        "description": "<b>Required scope: </b><code>project_portfolio_settings:read</code>\n\nReturns a compact representation of all of the project portfolio settings for the given portfolio.",
        "operationId": "getProjectPortfolioSettingsForPortfolio",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_at",
              "is_access_control_inherited",
              "offset",
              "path",
              "portfolio",
              "project",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_at",
                  "is_access_control_inherited",
                  "offset",
                  "path",
                  "portfolio",
                  "project",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/ProjectPortfolioSettingCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ProjectPortfolioSettingResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested portfolio's project portfolio settings."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "project_portfolio_settings:read"
            ]
          }
        ],
        "summary": "Get project portfolio settings for a portfolio",
        "tags": [
          "Project portfolio settings"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1portfolios~1{portfolio_gid}~1project_portfolio_settings/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectPortfolioSettingsApiInstance = new Asana.ProjectPortfolioSettingsApi(client);\nlet portfolio_gid = \"12345\"; // String | Globally unique identifier for the portfolio.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"created_at,is_access_control_inherited,offset,path,portfolio,project,uri\"\n};\nprojectPortfolioSettingsApiInstance.getProjectPortfolioSettingsForPortfolio(portfolio_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nproject_portfolio_settings_api_instance = asana.ProjectPortfolioSettingsApi(api_client)\nportfolio_gid = \"12345\" # str | Globally unique identifier for the portfolio.\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    'opt_fields': \"created_at,is_access_control_inherited,offset,path,portfolio,project,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get project portfolio settings for a portfolio\n    api_response = project_portfolio_settings_api_instance.get_project_portfolio_settings_for_portfolio(portfolio_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectPortfolioSettingsApi->get_project_portfolio_settings_for_portfolio: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/portfolio_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/portfolios/{portfolio_gid}/removeCustomFieldSetting": {
      "parameters": [
        {
          "$ref": "#/components/parameters/portfolio_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>portfolios:write</code>\n\nRemoves a custom field setting from a portfolio.",
        "operationId": "removeCustomFieldSettingForPortfolio",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/RemoveCustomFieldSettingRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Information about the custom field setting being removed.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully removed the custom field from the portfolio."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "portfolios:write"
            ]
          }
        ],
        "summary": "Remove a custom field from a portfolio",
        "tags": [
          "Portfolios"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1portfolios~1{portfolio_gid}~1removeCustomFieldSetting/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.portfolios.removeCustomFieldSettingForPortfolio(portfolioGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet portfoliosApiInstance = new Asana.PortfoliosApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | Information about the custom field setting being removed.\nlet portfolio_gid = \"12345\"; // String | Globally unique identifier for the portfolio.\n\nportfoliosApiInstance.removeCustomFieldSettingForPortfolio(body, portfolio_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.portfolios.removeCustomFieldSettingForPortfolio(portfolioGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nportfolios_api_instance = asana.PortfoliosApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | Information about the custom field setting being removed.\nportfolio_gid = \"12345\" # str | Globally unique identifier for the portfolio.\n\n\ntry:\n    # Remove a custom field from a portfolio\n    api_response = portfolios_api_instance.remove_custom_field_setting_for_portfolio(body, portfolio_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling PortfoliosApi->remove_custom_field_setting_for_portfolio: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.portfolios.remove_custom_field_setting_for_portfolio(portfolio_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->portfolios->removeCustomFieldSettingForPortfolio($portfolio_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.portfolios.remove_custom_field_setting_for_portfolio(portfolio_gid: 'portfolio_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/portfolios/{portfolio_gid}/removeItem": {
      "parameters": [
        {
          "$ref": "#/components/parameters/portfolio_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>portfolios:write</code>\n\nRemove an item from a portfolio.\nReturns an empty data block.",
        "operationId": "removeItemForPortfolio",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/PortfolioRemoveItemRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Information about the item being removed.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully removed the item from the portfolio."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "portfolios:write"
            ]
          }
        ],
        "summary": "Remove a portfolio item",
        "tags": [
          "Portfolios"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1portfolios~1{portfolio_gid}~1removeItem/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.portfolios.removeItemForPortfolio(portfolioGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet portfoliosApiInstance = new Asana.PortfoliosApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | Information about the item being removed.\nlet portfolio_gid = \"12345\"; // String | Globally unique identifier for the portfolio.\n\nportfoliosApiInstance.removeItemForPortfolio(body, portfolio_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.portfolios.removeItemForPortfolio(portfolioGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nportfolios_api_instance = asana.PortfoliosApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | Information about the item being removed.\nportfolio_gid = \"12345\" # str | Globally unique identifier for the portfolio.\n\n\ntry:\n    # Remove a portfolio item\n    api_response = portfolios_api_instance.remove_item_for_portfolio(body, portfolio_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling PortfoliosApi->remove_item_for_portfolio: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.portfolios.remove_item_for_portfolio(portfolio_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->portfolios->removeItemForPortfolio($portfolio_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.portfolios.remove_item_for_portfolio(portfolio_gid: 'portfolio_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/portfolios/{portfolio_gid}/removeMembers": {
      "parameters": [
        {
          "$ref": "#/components/parameters/portfolio_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "Removes the specified list of users from members of the portfolio.\nReturns the updated portfolio record.",
        "operationId": "removeMembersForPortfolio",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "archived",
              "color",
              "created_at",
              "created_by",
              "created_by.name",
              "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.default_access_level",
              "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.html_text_value",
              "custom_field_settings.custom_field.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_global_to_workspace",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.privacy_setting",
              "custom_field_settings.custom_field.reference_value",
              "custom_field_settings.custom_field.reference_value.name",
              "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.parent.resource_subtype",
              "custom_field_settings.project",
              "custom_field_settings.project.name",
              "custom_field_settings.project.resource_subtype",
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "default_access_level",
              "due_on",
              "members",
              "members.name",
              "name",
              "owner",
              "owner.name",
              "permalink_url",
              "privacy_setting",
              "project_templates",
              "project_templates.name",
              "public",
              "resource_subtype",
              "start_on",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "archived",
                  "color",
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "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.default_access_level",
                  "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.html_text_value",
                  "custom_field_settings.custom_field.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_global_to_workspace",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.privacy_setting",
                  "custom_field_settings.custom_field.reference_value",
                  "custom_field_settings.custom_field.reference_value.name",
                  "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.parent.resource_subtype",
                  "custom_field_settings.project",
                  "custom_field_settings.project.name",
                  "custom_field_settings.project.resource_subtype",
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "default_access_level",
                  "due_on",
                  "members",
                  "members.name",
                  "name",
                  "owner",
                  "owner.name",
                  "permalink_url",
                  "privacy_setting",
                  "project_templates",
                  "project_templates.name",
                  "public",
                  "resource_subtype",
                  "start_on",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/RemoveMembersRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Information about the members being removed.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/PortfolioResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__PortfolioResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully removed the members from the portfolio."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Remove users from a portfolio",
        "tags": [
          "Portfolios"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1portfolios~1{portfolio_gid}~1removeMembers/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nPortfolio result = client.portfolios.removeMembersForPortfolio(portfolioGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet portfoliosApiInstance = new Asana.PortfoliosApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | Information about the members being removed.\nlet portfolio_gid = \"12345\"; // String | Globally unique identifier for the portfolio.\nlet opts = { \n    'opt_fields': \"archived,color,created_at,created_by,created_by.name,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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,default_access_level,due_on,members,members.name,name,owner,owner.name,permalink_url,privacy_setting,project_templates,project_templates.name,public,resource_subtype,start_on,workspace,workspace.name\"\n};\nportfoliosApiInstance.removeMembersForPortfolio(body, portfolio_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.portfolios.removeMembersForPortfolio(portfolioGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nportfolios_api_instance = asana.PortfoliosApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | Information about the members being removed.\nportfolio_gid = \"12345\" # str | Globally unique identifier for the portfolio.\nopts = {\n    'opt_fields': \"archived,color,created_at,created_by,created_by.name,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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,default_access_level,due_on,members,members.name,name,owner,owner.name,permalink_url,privacy_setting,project_templates,project_templates.name,public,resource_subtype,start_on,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Remove users from a portfolio\n    api_response = portfolios_api_instance.remove_members_for_portfolio(body, portfolio_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling PortfoliosApi->remove_members_for_portfolio: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.portfolios.remove_members_for_portfolio(portfolio_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->portfolios->removeMembersForPortfolio($portfolio_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.portfolios.remove_members_for_portfolio(portfolio_gid: 'portfolio_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/project_briefs/{project_brief_gid}": {
      "delete": {
        "description": "Deletes a specific, existing project brief.\n\nReturns an empty data record.",
        "operationId": "deleteProjectBrief",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully deleted the specified project brief."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Delete a project brief",
        "tags": [
          "Project briefs"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1project_briefs~1{project_brief_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.projectbriefs.deleteProjectBrief(projectBriefGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectBriefsApiInstance = new Asana.ProjectBriefsApi(client);\nlet project_brief_gid = \"12345\"; // String | Globally unique identifier for the project brief.\n\nprojectBriefsApiInstance.deleteProjectBrief(project_brief_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projectbriefs.deleteProjectBrief(projectBriefGid)\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nproject_briefs_api_instance = asana.ProjectBriefsApi(api_client)\nproject_brief_gid = \"12345\" # str | Globally unique identifier for the project brief.\n\n\ntry:\n    # Delete a project brief\n    api_response = project_briefs_api_instance.delete_project_brief(project_brief_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectBriefsApi->delete_project_brief: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.project_briefs.delete_project_brief(project_brief_gid, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projectbriefs->deleteProjectBrief($project_brief_gid, array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.project_briefs.delete_project_brief(project_brief_gid: 'project_brief_gid', options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "get": {
        "description": "Get the full record for a project brief.",
        "operationId": "getProjectBrief",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "html_text",
              "permalink_url",
              "project",
              "project.name",
              "project.resource_subtype",
              "text",
              "title"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "html_text",
                  "permalink_url",
                  "project",
                  "project.name",
                  "project.resource_subtype",
                  "text",
                  "title"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/ProjectBriefResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ProjectBriefResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the record for a project brief."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "424": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          },
          "501": {
            "$ref": "#/components/responses/BadGateway"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          },
          "504": {
            "$ref": "#/components/responses/GatewayTimeout"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get a project brief",
        "tags": [
          "Project briefs"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1project_briefs~1{project_brief_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.projectbriefs.getProjectBrief(projectBriefGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectBriefsApiInstance = new Asana.ProjectBriefsApi(client);\nlet project_brief_gid = \"12345\"; // String | Globally unique identifier for the project brief.\nlet opts = { \n    'opt_fields': \"html_text,permalink_url,project,project.name,project.resource_subtype,text,title\"\n};\nprojectBriefsApiInstance.getProjectBrief(project_brief_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projectbriefs.getProjectBrief(projectBriefGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nproject_briefs_api_instance = asana.ProjectBriefsApi(api_client)\nproject_brief_gid = \"12345\" # str | Globally unique identifier for the project brief.\nopts = {\n    'opt_fields': \"html_text,permalink_url,project,project.name,project.resource_subtype,text,title\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a project brief\n    api_response = project_briefs_api_instance.get_project_brief(project_brief_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectBriefsApi->get_project_brief: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.project_briefs.get_project_brief(project_brief_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projectbriefs->getProjectBrief($project_brief_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.project_briefs.get_project_brief(project_brief_gid: 'project_brief_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/project_brief_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "put": {
        "description": "An existing project brief can be updated by making a PUT request on the URL for\nthat project brief. Only the fields provided in the `data` block will be updated;\nany unspecified fields will remain unchanged.\n\nReturns the complete updated project brief record.",
        "operationId": "updateProjectBrief",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "html_text",
              "permalink_url",
              "project",
              "project.name",
              "project.resource_subtype",
              "text",
              "title"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "html_text",
                  "permalink_url",
                  "project",
                  "project.name",
                  "project.resource_subtype",
                  "text",
                  "title"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/ProjectBriefRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The updated fields for the project brief.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/ProjectBriefResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ProjectBriefResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully updated the project brief."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Update a project brief",
        "tags": [
          "Project briefs"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1project_briefs~1{project_brief_gid}/put",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.projectbriefs.updateProjectBrief(projectBriefGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectBriefsApiInstance = new Asana.ProjectBriefsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The updated fields for the project brief.\nlet project_brief_gid = \"12345\"; // String | Globally unique identifier for the project brief.\nlet opts = { \n    'opt_fields': \"html_text,permalink_url,project,project.name,project.resource_subtype,text,title\"\n};\nprojectBriefsApiInstance.updateProjectBrief(body, project_brief_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projectbriefs.updateProjectBrief(projectBriefGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nproject_briefs_api_instance = asana.ProjectBriefsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The updated fields for the project brief.\nproject_brief_gid = \"12345\" # str | Globally unique identifier for the project brief.\nopts = {\n    'opt_fields': \"html_text,permalink_url,project,project.name,project.resource_subtype,text,title\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Update a project brief\n    api_response = project_briefs_api_instance.update_project_brief(body, project_brief_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectBriefsApi->update_project_brief: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.project_briefs.update_project_brief(project_brief_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projectbriefs->updateProjectBrief($project_brief_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.project_briefs.update_project_brief(project_brief_gid: 'project_brief_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/project_memberships/{project_membership_gid}": {
      "get": {
        "description": "Returns the complete project record for a single project membership.",
        "operationId": "getProjectMembership",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "access_level",
              "member",
              "member.name",
              "parent",
              "parent.name",
              "parent.resource_subtype",
              "project",
              "project.name",
              "project.resource_subtype",
              "user",
              "user.name",
              "write_access"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "access_level",
                  "member",
                  "member.name",
                  "parent",
                  "parent.name",
                  "parent.resource_subtype",
                  "project",
                  "project.name",
                  "project.resource_subtype",
                  "user",
                  "user.name",
                  "write_access"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/ProjectMembershipNormalResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ProjectMembershipNormalResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested project membership."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get a project membership",
        "tags": [
          "Project memberships"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1project_memberships~1{project_membership_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nProjectMembership result = client.projectmemberships.getProjectMembership(projectMembershipGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectMembershipsApiInstance = new Asana.ProjectMembershipsApi(client);\nlet project_membership_gid = \"1331\"; // String | \nlet opts = { \n    'opt_fields': \"access_level,member,member.name,parent,parent.name,parent.resource_subtype,project,project.name,project.resource_subtype,user,user.name,write_access\"\n};\nprojectMembershipsApiInstance.getProjectMembership(project_membership_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projectmemberships.getProjectMembership(projectMembershipGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nproject_memberships_api_instance = asana.ProjectMembershipsApi(api_client)\nproject_membership_gid = \"1331\" # str | \nopts = {\n    'opt_fields': \"access_level,member,member.name,parent,parent.name,parent.resource_subtype,project,project.name,project.resource_subtype,user,user.name,write_access\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a project membership\n    api_response = project_memberships_api_instance.get_project_membership(project_membership_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectMembershipsApi->get_project_membership: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.project_memberships.get_project_membership(project_membership_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projectmemberships->getProjectMembership($project_membership_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.project_memberships.get_project_membership(project_membership_gid: 'project_membership_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/project_membership_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/project_portfolio_settings/{project_portfolio_setting_gid}": {
      "get": {
        "description": "<b>Required scope: </b><code>project_portfolio_settings:read</code>\n\nReturns the complete project portfolio setting record for a single project portfolio setting.",
        "operationId": "getProjectPortfolioSetting",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_at",
              "is_access_control_inherited",
              "portfolio",
              "project"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_at",
                  "is_access_control_inherited",
                  "portfolio",
                  "project"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/ProjectPortfolioSettingResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ProjectPortfolioSettingResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested project portfolio setting."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "project_portfolio_settings:read"
            ]
          }
        ],
        "summary": "Get a project portfolio setting",
        "tags": [
          "Project portfolio settings"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1project_portfolio_settings~1{project_portfolio_setting_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectPortfolioSettingsApiInstance = new Asana.ProjectPortfolioSettingsApi(client);\nlet project_portfolio_setting_gid = \"1331\"; // String | Globally unique identifier for the project portfolio setting.\nlet opts = { \n    'opt_fields': \"created_at,is_access_control_inherited,portfolio,project\"\n};\nprojectPortfolioSettingsApiInstance.getProjectPortfolioSetting(project_portfolio_setting_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nproject_portfolio_settings_api_instance = asana.ProjectPortfolioSettingsApi(api_client)\nproject_portfolio_setting_gid = \"1331\" # str | Globally unique identifier for the project portfolio setting.\nopts = {\n    'opt_fields': \"created_at,is_access_control_inherited,portfolio,project\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a project portfolio setting\n    api_response = project_portfolio_settings_api_instance.get_project_portfolio_setting(project_portfolio_setting_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectPortfolioSettingsApi->get_project_portfolio_setting: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/project_portfolio_setting_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/project_statuses/{project_status_gid}": {
      "delete": {
        "description": "*Deprecated: new integrations should prefer the `/status_updates/{status_gid}` route.*\n\nDeletes a specific, existing project status update.\n\nReturns an empty data record.",
        "operationId": "deleteProjectStatus",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully deleted the specified project status."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Delete a project status",
        "tags": [
          "Project statuses"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1project_statuses~1{project_status_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.projectstatuses.deleteProjectStatus(projectStatusGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectStatusesApiInstance = new Asana.ProjectStatusesApi(client);\nlet project_status_gid = \"321654\"; // String | The project status update to get.\n\nprojectStatusesApiInstance.deleteProjectStatus(project_status_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projectstatuses.deleteProjectStatus(projectStatusGid)\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nproject_statuses_api_instance = asana.ProjectStatusesApi(api_client)\nproject_status_gid = \"321654\" # str | The project status update to get.\n\n\ntry:\n    # Delete a project status\n    api_response = project_statuses_api_instance.delete_project_status(project_status_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectStatusesApi->delete_project_status: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.project_statuses.delete_project_status(project_status_gid, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projectstatuses->deleteProjectStatus($project_status_gid, array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.project_statuses.delete_project_status(project_status_gid: 'project_status_gid', options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "get": {
        "description": "*Deprecated: new integrations should prefer the `/status_updates/{status_gid}` route.*\n\nReturns the complete record for a single status update.",
        "operationId": "getProjectStatus",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "author",
              "author.name",
              "color",
              "created_at",
              "created_by",
              "created_by.name",
              "html_text",
              "modified_at",
              "text",
              "title"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "author",
                  "author.name",
                  "color",
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "html_text",
                  "modified_at",
                  "text",
                  "title"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/ProjectStatusResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ProjectStatusResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the specified project's status updates."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get a project status",
        "tags": [
          "Project statuses"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1project_statuses~1{project_status_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nProjectStatus result = client.projectstatuses.getProjectStatus(projectStatusGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectStatusesApiInstance = new Asana.ProjectStatusesApi(client);\nlet project_status_gid = \"321654\"; // String | The project status update to get.\nlet opts = { \n    'opt_fields': \"author,author.name,color,created_at,created_by,created_by.name,html_text,modified_at,text,title\"\n};\nprojectStatusesApiInstance.getProjectStatus(project_status_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projectstatuses.getProjectStatus(projectStatusGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nproject_statuses_api_instance = asana.ProjectStatusesApi(api_client)\nproject_status_gid = \"321654\" # str | The project status update to get.\nopts = {\n    'opt_fields': \"author,author.name,color,created_at,created_by,created_by.name,html_text,modified_at,text,title\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a project status\n    api_response = project_statuses_api_instance.get_project_status(project_status_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectStatusesApi->get_project_status: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.project_statuses.get_project_status(project_status_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projectstatuses->getProjectStatus($project_status_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.project_statuses.get_project_status(project_status_gid: 'project_status_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/project_status_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/project_templates": {
      "get": {
        "description": "<b>Required scope: </b><code>project_templates:read</code>\n\nReturns the compact project template records for all project templates in the given team or workspace.",
        "operationId": "getProjectTemplates",
        "parameters": [
          {
            "$ref": "#/components/parameters/workspace_query_param"
          },
          {
            "$ref": "#/components/parameters/team_query_param"
          },
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "color",
              "description",
              "html_description",
              "name",
              "offset",
              "owner",
              "path",
              "public",
              "requested_dates",
              "requested_dates.description",
              "requested_dates.name",
              "requested_roles",
              "requested_roles.name",
              "team",
              "team.name",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "color",
                  "description",
                  "html_description",
                  "name",
                  "offset",
                  "owner",
                  "path",
                  "public",
                  "requested_dates",
                  "requested_dates.description",
                  "requested_dates.name",
                  "requested_roles",
                  "requested_roles.name",
                  "team",
                  "team.name",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/ProjectTemplateCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ProjectTemplateResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested team's or workspace's project templates."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "project_templates:read"
            ]
          }
        ],
        "summary": "Get multiple project templates",
        "tags": [
          "Project templates"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1project_templates/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<JsonElement> result = client.projecttemplates.getProjectTemplates(team, workspace)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectTemplatesApiInstance = new Asana.ProjectTemplatesApi(client);\nlet opts = { \n    'workspace': \"12345\", \n    'team': \"14916\", \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"color,description,html_description,name,offset,owner,path,public,requested_dates,requested_dates.description,requested_dates.name,requested_roles,requested_roles.name,team,team.name,uri\"\n};\nprojectTemplatesApiInstance.getProjectTemplates(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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projecttemplates.getProjectTemplates({param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nproject_templates_api_instance = asana.ProjectTemplatesApi(api_client)\nopts = {\n    'workspace': \"12345\", # str | The workspace to filter results on.\n    'team': \"14916\", # str | The team to filter projects on.\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    'opt_fields': \"color,description,html_description,name,offset,owner,path,public,requested_dates,requested_dates.description,requested_dates.name,requested_roles,requested_roles.name,team,team.name,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get multiple project templates\n    api_response = project_templates_api_instance.get_project_templates(opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectTemplatesApi->get_project_templates: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.project_templates.get_project_templates({'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projecttemplates->getProjectTemplates(array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.project_templates.get_project_templates(param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/project_templates/{project_template_gid}": {
      "delete": {
        "description": "A specific, existing project template can be deleted by making a DELETE request on the URL for that project template.\n\nReturns an empty data record.",
        "operationId": "deleteProjectTemplate",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully deleted the specified project template."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Delete a project template",
        "tags": [
          "Project templates"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1project_templates~1{project_template_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectTemplatesApiInstance = new Asana.ProjectTemplatesApi(client);\nlet project_template_gid = \"1331\"; // String | Globally unique identifier for the project template.\n\nprojectTemplatesApiInstance.deleteProjectTemplate(project_template_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projecttemplates.deleteProjectTemplate(projectTemplateGid)\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nproject_templates_api_instance = asana.ProjectTemplatesApi(api_client)\nproject_template_gid = \"1331\" # str | Globally unique identifier for the project template.\n\n\ntry:\n    # Delete a project template\n    api_response = project_templates_api_instance.delete_project_template(project_template_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectTemplatesApi->delete_project_template: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.project_templates.delete_project_template(project_template_gid, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            }
          ]
        }
      },
      "get": {
        "description": "<b>Required scope: </b><code>project_templates:read</code>\n\nReturns the complete project template record for a single project template.",
        "operationId": "getProjectTemplate",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "color",
              "description",
              "html_description",
              "name",
              "owner",
              "public",
              "requested_dates",
              "requested_dates.description",
              "requested_dates.name",
              "requested_roles",
              "requested_roles.name",
              "team",
              "team.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "color",
                  "description",
                  "html_description",
                  "name",
                  "owner",
                  "public",
                  "requested_dates",
                  "requested_dates.description",
                  "requested_dates.name",
                  "requested_roles",
                  "requested_roles.name",
                  "team",
                  "team.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/ProjectTemplateResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ProjectTemplateResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested project template."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "project_templates:read"
            ]
          }
        ],
        "summary": "Get a project template",
        "tags": [
          "Project templates"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1project_templates~1{project_template_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.projecttemplates.getProjectTemplate(projectTemplateGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectTemplatesApiInstance = new Asana.ProjectTemplatesApi(client);\nlet project_template_gid = \"1331\"; // String | Globally unique identifier for the project template.\nlet opts = { \n    'opt_fields': \"color,description,html_description,name,owner,public,requested_dates,requested_dates.description,requested_dates.name,requested_roles,requested_roles.name,team,team.name\"\n};\nprojectTemplatesApiInstance.getProjectTemplate(project_template_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projecttemplates.getProjectTemplate(projectTemplateGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nproject_templates_api_instance = asana.ProjectTemplatesApi(api_client)\nproject_template_gid = \"1331\" # str | Globally unique identifier for the project template.\nopts = {\n    'opt_fields': \"color,description,html_description,name,owner,public,requested_dates,requested_dates.description,requested_dates.name,requested_roles,requested_roles.name,team,team.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a project template\n    api_response = project_templates_api_instance.get_project_template(project_template_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectTemplatesApi->get_project_template: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.project_templates.get_project_template(project_template_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projecttemplates->getProjectTemplate($project_template_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.project_templates.get_project_template(project_template_gid: 'project_template_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/project_template_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/project_templates/{project_template_gid}/instantiateProject": {
      "parameters": [
        {
          "$ref": "#/components/parameters/project_template_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>projects:write</code>\n\nCreates and returns a job that will asynchronously handle the project instantiation.\n\nTo form this request, it is recommended to first make a request to [get a project template](/reference/getprojecttemplate). Then, from the response, copy the `gid` from the object in the `requested_dates` array. This `gid` should be used in `requested_dates` to instantiate a project.\n\n_Note: The body of this request will differ if your workspace is an organization. To determine if your workspace is an organization, use the [is_organization](/reference/workspaces) parameter._",
        "operationId": "instantiateProject",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "dates_rollup_progress",
              "dates_rollup_progress.total_tasks",
              "dates_rollup_progress.updated_tasks",
              "new_graph_export",
              "new_graph_export.completed_at",
              "new_graph_export.created_at",
              "new_graph_export.download_url",
              "new_portfolio",
              "new_portfolio.name",
              "new_portfolio.resource_subtype",
              "new_project",
              "new_project.name",
              "new_project.resource_subtype",
              "new_project_template",
              "new_project_template.name",
              "new_resource_export",
              "new_resource_export.completed_at",
              "new_resource_export.created_at",
              "new_resource_export.download_url",
              "new_task",
              "new_task.created_by",
              "new_task.name",
              "new_task.resource_subtype",
              "resource_subtype",
              "status"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "dates_rollup_progress",
                  "dates_rollup_progress.total_tasks",
                  "dates_rollup_progress.updated_tasks",
                  "new_graph_export",
                  "new_graph_export.completed_at",
                  "new_graph_export.created_at",
                  "new_graph_export.download_url",
                  "new_portfolio",
                  "new_portfolio.name",
                  "new_portfolio.resource_subtype",
                  "new_project",
                  "new_project.name",
                  "new_project.resource_subtype",
                  "new_project_template",
                  "new_project_template.name",
                  "new_resource_export",
                  "new_resource_export.completed_at",
                  "new_resource_export.created_at",
                  "new_resource_export.download_url",
                  "new_task",
                  "new_task.created_by",
                  "new_task.name",
                  "new_task.resource_subtype",
                  "resource_subtype",
                  "status"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/ProjectTemplateInstantiateProjectRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Describes the inputs used for instantiating a project, such as the resulting project's name, which team it should be created in, and values for date variables."
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/JobResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__JobResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created the job to handle project instantiation."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "projects:write"
            ]
          }
        ],
        "summary": "Instantiate a project from a project template",
        "tags": [
          "Project templates"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1project_templates~1{project_template_gid}~1instantiateProject/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJob result = client.projecttemplates.instantiateProject(projectTemplateGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectTemplatesApiInstance = new Asana.ProjectTemplatesApi(client);\nlet project_template_gid = \"1331\"; // String | Globally unique identifier for the project template.\nlet opts = { \n    'body': {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}, \n    'opt_fields': \"dates_rollup_progress,dates_rollup_progress.total_tasks,dates_rollup_progress.updated_tasks,new_graph_export,new_graph_export.completed_at,new_graph_export.created_at,new_graph_export.download_url,new_portfolio,new_portfolio.name,new_portfolio.resource_subtype,new_project,new_project.name,new_project.resource_subtype,new_project_template,new_project_template.name,new_resource_export,new_resource_export.completed_at,new_resource_export.created_at,new_resource_export.download_url,new_task,new_task.created_by,new_task.name,new_task.resource_subtype,resource_subtype,status\"\n};\nprojectTemplatesApiInstance.instantiateProject(project_template_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projecttemplates.instantiateProject(projectTemplateGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nproject_templates_api_instance = asana.ProjectTemplatesApi(api_client)\nproject_template_gid = \"1331\" # str | Globally unique identifier for the project template.\nopts = {\n    'body': {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}, # dict | Describes the inputs used for instantiating a project, such as the resulting project's name, which team it should be created in, and values for date variables.\n    'opt_fields': \"dates_rollup_progress,dates_rollup_progress.total_tasks,dates_rollup_progress.updated_tasks,new_graph_export,new_graph_export.completed_at,new_graph_export.created_at,new_graph_export.download_url,new_portfolio,new_portfolio.name,new_portfolio.resource_subtype,new_project,new_project.name,new_project.resource_subtype,new_project_template,new_project_template.name,new_resource_export,new_resource_export.completed_at,new_resource_export.created_at,new_resource_export.download_url,new_task,new_task.created_by,new_task.name,new_task.resource_subtype,resource_subtype,status\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Instantiate a project from a project template\n    api_response = project_templates_api_instance.instantiate_project(project_template_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectTemplatesApi->instantiate_project: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.project_templates.instantiate_project(project_template_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projecttemplates->instantiateProject($project_template_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.project_templates.instantiate_project(project_template_gid: 'project_template_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/projects": {
      "get": {
        "description": "<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.",
        "operationId": "getProjects",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "The workspace or organization to filter projects on.",
            "example": "1331",
            "in": "query",
            "name": "workspace",
            "schema": {
              "type": "string"
            }
          },
          {
            "deprecated": true,
            "description": "**Deprecated.** The team to filter projects on. Please use `GET /memberships` with `{ member: team, resource_subtype: project_membership }` instead.",
            "example": "14916",
            "in": "query",
            "name": "team",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/archived_query_param"
          },
          {
            "$ref": "#/components/parameters/custom_type_query_param"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "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.default_access_level",
              "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.html_text_value",
              "custom_field_settings.custom_field.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_global_to_workspace",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.privacy_setting",
              "custom_field_settings.custom_field.reference_value",
              "custom_field_settings.custom_field.reference_value.name",
              "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.parent.resource_subtype",
              "custom_field_settings.project",
              "custom_field_settings.project.name",
              "custom_field_settings.project.resource_subtype",
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "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",
              "resource_subtype",
              "start_on",
              "team",
              "team.name",
              "uri",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "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.default_access_level",
                  "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.html_text_value",
                  "custom_field_settings.custom_field.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_global_to_workspace",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.privacy_setting",
                  "custom_field_settings.custom_field.reference_value",
                  "custom_field_settings.custom_field.reference_value.name",
                  "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.parent.resource_subtype",
                  "custom_field_settings.project",
                  "custom_field_settings.project.name",
                  "custom_field_settings.project.resource_subtype",
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "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",
                  "resource_subtype",
                  "start_on",
                  "team",
                  "team.name",
                  "uri",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/ProjectCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ProjectResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved projects."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "projects:read"
            ]
          }
        ],
        "summary": "Get multiple projects",
        "tags": [
          "Projects"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1projects/get",
        "x-readme": {
          "code-samples": [
            {
              "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();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectsApiInstance = new Asana.ProjectsApi(client);\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'workspace': \"1331\", \n    'team': \"14916\", \n    'archived': false, \n    'custom_type': \"12345\", \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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,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,resource_subtype,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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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 | **Deprecated.** The team to filter projects on. Please use `GET /memberships` with `{ member: team, resource_subtype: project_membership }` instead.\n    'archived': False, # bool | Only return projects whose `archived` field takes on the value of this parameter.\n    'custom_type': \"12345\", # str | Filter results by custom type. Provide a custom type GID to return only objects of that custom type (an unknown GID returns `400`). Provide an empty string to return only objects with no custom type assigned. If this parameter is omitted, results are not filtered by custom type.\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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,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,resource_subtype,start_on,team,team.name,uri,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\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)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.projects.get_projects({'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projects->getProjects(array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "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})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/projects/{project_gid}": {
      "delete": {
        "description": "<b>Required scope: </b><code>projects:delete</code>\n\nA specific, existing project can be deleted by making a DELETE request on\nthe URL for that project.\n\nReturns an empty data record.",
        "operationId": "deleteProject",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully deleted the specified project."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "projects:delete"
            ]
          }
        ],
        "summary": "Delete a project",
        "tags": [
          "Projects"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1projects~1{project_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.projects.deleteProject(projectGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectsApiInstance = new Asana.ProjectsApi(client);\nlet project_gid = \"1331\"; // String | Globally unique identifier for the project.\n\nprojectsApiInstance.deleteProject(project_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projects.deleteProject(projectGid)\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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)\nproject_gid = \"1331\" # str | Globally unique identifier for the project.\n\n\ntry:\n    # Delete a project\n    api_response = projects_api_instance.delete_project(project_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectsApi->delete_project: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.projects.delete_project(project_gid, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projects->deleteProject($project_gid, array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.projects.delete_project(project_gid: 'project_gid', options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "get": {
        "description": "<b>Required scope: </b><code>projects:read</code>\n\n<table>\n  <tr>\n    <th>Field</th>\n    <th>Required Scope</th>\n  </tr>\n  <tr>\n    <td><code>team</code></td>\n    <td><code>teams:read</code></td>\n  </tr>\n  <tr>\n    <td><code>custom_type</code></td>\n    <td><code>custom_types:read</code></td>\n  </tr>\n</table>\n\nReturns the complete project record for a single project.",
        "operationId": "getProject",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "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.default_access_level",
              "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.html_text_value",
              "custom_field_settings.custom_field.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_global_to_workspace",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.privacy_setting",
              "custom_field_settings.custom_field.reference_value",
              "custom_field_settings.custom_field.reference_value.name",
              "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.parent.resource_subtype",
              "custom_field_settings.project",
              "custom_field_settings.project.name",
              "custom_field_settings.project.resource_subtype",
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "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",
              "resource_subtype",
              "start_on",
              "team",
              "team.name",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "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.default_access_level",
                  "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.html_text_value",
                  "custom_field_settings.custom_field.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_global_to_workspace",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.privacy_setting",
                  "custom_field_settings.custom_field.reference_value",
                  "custom_field_settings.custom_field.reference_value.name",
                  "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.parent.resource_subtype",
                  "custom_field_settings.project",
                  "custom_field_settings.project.name",
                  "custom_field_settings.project.resource_subtype",
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "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",
                  "resource_subtype",
                  "start_on",
                  "team",
                  "team.name",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/ProjectResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ProjectResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested project."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "projects:read"
            ]
          }
        ],
        "summary": "Get a project",
        "tags": [
          "Projects"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1projects~1{project_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nProject result = client.projects.getProject(projectGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectsApiInstance = new Asana.ProjectsApi(client);\nlet project_gid = \"1331\"; // String | Globally unique identifier for the project.\nlet opts = { \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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,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,resource_subtype,start_on,team,team.name,workspace,workspace.name\"\n};\nprojectsApiInstance.getProject(project_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projects.getProject(projectGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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)\nproject_gid = \"1331\" # str | Globally unique identifier for the project.\nopts = {\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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,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,resource_subtype,start_on,team,team.name,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a project\n    api_response = projects_api_instance.get_project(project_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectsApi->get_project: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.projects.get_project(project_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projects->getProject($project_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.projects.get_project(project_gid: 'project_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/project_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/projects/{project_gid}/addCustomFieldSetting": {
      "parameters": [
        {
          "$ref": "#/components/parameters/project_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>projects:write</code>\n\nCustom fields are associated with projects by way of custom field settings.  This method creates a setting for the project.",
        "operationId": "addCustomFieldSettingForProject",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "custom_field",
              "custom_field.asana_created_field",
              "custom_field.created_by",
              "custom_field.created_by.name",
              "custom_field.currency_code",
              "custom_field.custom_label",
              "custom_field.custom_label_position",
              "custom_field.date_value",
              "custom_field.date_value.date",
              "custom_field.date_value.date_time",
              "custom_field.default_access_level",
              "custom_field.description",
              "custom_field.display_value",
              "custom_field.enabled",
              "custom_field.enum_options",
              "custom_field.enum_options.color",
              "custom_field.enum_options.enabled",
              "custom_field.enum_options.name",
              "custom_field.enum_value",
              "custom_field.enum_value.color",
              "custom_field.enum_value.enabled",
              "custom_field.enum_value.name",
              "custom_field.format",
              "custom_field.has_notifications_enabled",
              "custom_field.html_text_value",
              "custom_field.id_prefix",
              "custom_field.input_restrictions",
              "custom_field.is_formula_field",
              "custom_field.is_global_to_workspace",
              "custom_field.is_lookup_field",
              "custom_field.is_value_read_only",
              "custom_field.multi_enum_values",
              "custom_field.multi_enum_values.color",
              "custom_field.multi_enum_values.enabled",
              "custom_field.multi_enum_values.name",
              "custom_field.name",
              "custom_field.number_value",
              "custom_field.people_value",
              "custom_field.people_value.name",
              "custom_field.precision",
              "custom_field.privacy_setting",
              "custom_field.reference_value",
              "custom_field.reference_value.name",
              "custom_field.representation_type",
              "custom_field.resource_subtype",
              "custom_field.text_value",
              "custom_field.type",
              "is_important",
              "parent",
              "parent.name",
              "parent.resource_subtype",
              "project",
              "project.name",
              "project.resource_subtype"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "custom_field",
                  "custom_field.asana_created_field",
                  "custom_field.created_by",
                  "custom_field.created_by.name",
                  "custom_field.currency_code",
                  "custom_field.custom_label",
                  "custom_field.custom_label_position",
                  "custom_field.date_value",
                  "custom_field.date_value.date",
                  "custom_field.date_value.date_time",
                  "custom_field.default_access_level",
                  "custom_field.description",
                  "custom_field.display_value",
                  "custom_field.enabled",
                  "custom_field.enum_options",
                  "custom_field.enum_options.color",
                  "custom_field.enum_options.enabled",
                  "custom_field.enum_options.name",
                  "custom_field.enum_value",
                  "custom_field.enum_value.color",
                  "custom_field.enum_value.enabled",
                  "custom_field.enum_value.name",
                  "custom_field.format",
                  "custom_field.has_notifications_enabled",
                  "custom_field.html_text_value",
                  "custom_field.id_prefix",
                  "custom_field.input_restrictions",
                  "custom_field.is_formula_field",
                  "custom_field.is_global_to_workspace",
                  "custom_field.is_lookup_field",
                  "custom_field.is_value_read_only",
                  "custom_field.multi_enum_values",
                  "custom_field.multi_enum_values.color",
                  "custom_field.multi_enum_values.enabled",
                  "custom_field.multi_enum_values.name",
                  "custom_field.name",
                  "custom_field.number_value",
                  "custom_field.people_value",
                  "custom_field.people_value.name",
                  "custom_field.precision",
                  "custom_field.privacy_setting",
                  "custom_field.reference_value",
                  "custom_field.reference_value.name",
                  "custom_field.representation_type",
                  "custom_field.resource_subtype",
                  "custom_field.text_value",
                  "custom_field.type",
                  "is_important",
                  "parent",
                  "parent.name",
                  "parent.resource_subtype",
                  "project",
                  "project.name",
                  "project.resource_subtype"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/AddCustomFieldSettingRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Information about the custom field setting.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/CustomFieldSettingResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__CustomFieldSettingResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully added the custom field to the project."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "projects:write"
            ]
          }
        ],
        "summary": "Add a custom field to a project",
        "tags": [
          "Projects"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1projects~1{project_gid}~1addCustomFieldSetting/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nCustomFieldSetting result = client.projects.addCustomFieldSettingForProject(projectGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectsApiInstance = new Asana.ProjectsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | Information about the custom field setting.\nlet project_gid = \"1331\"; // String | Globally unique identifier for the project.\nlet opts = { \n    'opt_fields': \"custom_field,custom_field.asana_created_field,custom_field.created_by,custom_field.created_by.name,custom_field.currency_code,custom_field.custom_label,custom_field.custom_label_position,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.default_access_level,custom_field.description,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.format,custom_field.has_notifications_enabled,custom_field.html_text_value,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_global_to_workspace,custom_field.is_lookup_field,custom_field.is_value_read_only,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.people_value,custom_field.people_value.name,custom_field.precision,custom_field.privacy_setting,custom_field.reference_value,custom_field.reference_value.name,custom_field.representation_type,custom_field.resource_subtype,custom_field.text_value,custom_field.type,is_important,parent,parent.name,parent.resource_subtype,project,project.name,project.resource_subtype\"\n};\nprojectsApiInstance.addCustomFieldSettingForProject(body, project_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projects.addCustomFieldSettingForProject(projectGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | Information about the custom field setting.\nproject_gid = \"1331\" # str | Globally unique identifier for the project.\nopts = {\n    'opt_fields': \"custom_field,custom_field.asana_created_field,custom_field.created_by,custom_field.created_by.name,custom_field.currency_code,custom_field.custom_label,custom_field.custom_label_position,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.default_access_level,custom_field.description,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.format,custom_field.has_notifications_enabled,custom_field.html_text_value,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_global_to_workspace,custom_field.is_lookup_field,custom_field.is_value_read_only,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.people_value,custom_field.people_value.name,custom_field.precision,custom_field.privacy_setting,custom_field.reference_value,custom_field.reference_value.name,custom_field.representation_type,custom_field.resource_subtype,custom_field.text_value,custom_field.type,is_important,parent,parent.name,parent.resource_subtype,project,project.name,project.resource_subtype\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Add a custom field to a project\n    api_response = projects_api_instance.add_custom_field_setting_for_project(body, project_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectsApi->add_custom_field_setting_for_project: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.projects.add_custom_field_setting_for_project(project_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projects->addCustomFieldSettingForProject($project_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.projects.add_custom_field_setting_for_project(project_gid: 'project_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/projects/{project_gid}/addFollowers": {
      "parameters": [
        {
          "$ref": "#/components/parameters/project_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/projects/{project_gid}/addMembers": {
      "parameters": [
        {
          "$ref": "#/components/parameters/project_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/projects/{project_gid}/custom_field_settings": {
      "get": {
        "description": "<b>Required scope: </b><code>projects:read</code>\n\nReturns a list of all of the custom fields settings on a project, in compact form. Note that, as in all queries to collections which return compact representation, `opt_fields` can be used to include more data than is returned in the compact representation. See the [documentation for input/output options](https://developers.asana.com/docs/inputoutput-options) for more information.",
        "operationId": "getCustomFieldSettingsForProject",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "custom_field",
              "custom_field.asana_created_field",
              "custom_field.created_by",
              "custom_field.created_by.name",
              "custom_field.currency_code",
              "custom_field.custom_label",
              "custom_field.custom_label_position",
              "custom_field.date_value",
              "custom_field.date_value.date",
              "custom_field.date_value.date_time",
              "custom_field.default_access_level",
              "custom_field.description",
              "custom_field.display_value",
              "custom_field.enabled",
              "custom_field.enum_options",
              "custom_field.enum_options.color",
              "custom_field.enum_options.enabled",
              "custom_field.enum_options.name",
              "custom_field.enum_value",
              "custom_field.enum_value.color",
              "custom_field.enum_value.enabled",
              "custom_field.enum_value.name",
              "custom_field.format",
              "custom_field.has_notifications_enabled",
              "custom_field.html_text_value",
              "custom_field.id_prefix",
              "custom_field.input_restrictions",
              "custom_field.is_formula_field",
              "custom_field.is_global_to_workspace",
              "custom_field.is_lookup_field",
              "custom_field.is_value_read_only",
              "custom_field.multi_enum_values",
              "custom_field.multi_enum_values.color",
              "custom_field.multi_enum_values.enabled",
              "custom_field.multi_enum_values.name",
              "custom_field.name",
              "custom_field.number_value",
              "custom_field.people_value",
              "custom_field.people_value.name",
              "custom_field.precision",
              "custom_field.privacy_setting",
              "custom_field.reference_value",
              "custom_field.reference_value.name",
              "custom_field.representation_type",
              "custom_field.resource_subtype",
              "custom_field.text_value",
              "custom_field.type",
              "is_important",
              "offset",
              "parent",
              "parent.name",
              "parent.resource_subtype",
              "path",
              "project",
              "project.name",
              "project.resource_subtype",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "custom_field",
                  "custom_field.asana_created_field",
                  "custom_field.created_by",
                  "custom_field.created_by.name",
                  "custom_field.currency_code",
                  "custom_field.custom_label",
                  "custom_field.custom_label_position",
                  "custom_field.date_value",
                  "custom_field.date_value.date",
                  "custom_field.date_value.date_time",
                  "custom_field.default_access_level",
                  "custom_field.description",
                  "custom_field.display_value",
                  "custom_field.enabled",
                  "custom_field.enum_options",
                  "custom_field.enum_options.color",
                  "custom_field.enum_options.enabled",
                  "custom_field.enum_options.name",
                  "custom_field.enum_value",
                  "custom_field.enum_value.color",
                  "custom_field.enum_value.enabled",
                  "custom_field.enum_value.name",
                  "custom_field.format",
                  "custom_field.has_notifications_enabled",
                  "custom_field.html_text_value",
                  "custom_field.id_prefix",
                  "custom_field.input_restrictions",
                  "custom_field.is_formula_field",
                  "custom_field.is_global_to_workspace",
                  "custom_field.is_lookup_field",
                  "custom_field.is_value_read_only",
                  "custom_field.multi_enum_values",
                  "custom_field.multi_enum_values.color",
                  "custom_field.multi_enum_values.enabled",
                  "custom_field.multi_enum_values.name",
                  "custom_field.name",
                  "custom_field.number_value",
                  "custom_field.people_value",
                  "custom_field.people_value.name",
                  "custom_field.precision",
                  "custom_field.privacy_setting",
                  "custom_field.reference_value",
                  "custom_field.reference_value.name",
                  "custom_field.representation_type",
                  "custom_field.resource_subtype",
                  "custom_field.text_value",
                  "custom_field.type",
                  "is_important",
                  "offset",
                  "parent",
                  "parent.name",
                  "parent.resource_subtype",
                  "path",
                  "project",
                  "project.name",
                  "project.resource_subtype",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/CustomFieldSettingResponse"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__CustomFieldSettingResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved custom field settings objects for a project."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "projects:read"
            ]
          }
        ],
        "summary": "Get a project's custom fields",
        "tags": [
          "Custom field settings"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1projects~1{project_gid}~1custom_field_settings/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<CustomFieldSetting> result = client.customfieldsettings.getCustomFieldSettingsForProject(projectGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet customFieldSettingsApiInstance = new Asana.CustomFieldSettingsApi(client);\nlet project_gid = \"1331\"; // String | Globally unique identifier for the project.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"custom_field,custom_field.asana_created_field,custom_field.created_by,custom_field.created_by.name,custom_field.currency_code,custom_field.custom_label,custom_field.custom_label_position,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.default_access_level,custom_field.description,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.format,custom_field.has_notifications_enabled,custom_field.html_text_value,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_global_to_workspace,custom_field.is_lookup_field,custom_field.is_value_read_only,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.people_value,custom_field.people_value.name,custom_field.precision,custom_field.privacy_setting,custom_field.reference_value,custom_field.reference_value.name,custom_field.representation_type,custom_field.resource_subtype,custom_field.text_value,custom_field.type,is_important,offset,parent,parent.name,parent.resource_subtype,path,project,project.name,project.resource_subtype,uri\"\n};\ncustomFieldSettingsApiInstance.getCustomFieldSettingsForProject(project_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.customfieldsettings.getCustomFieldSettingsForProject(projectGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ncustom_field_settings_api_instance = asana.CustomFieldSettingsApi(api_client)\nproject_gid = \"1331\" # str | Globally unique identifier for the project.\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    'opt_fields': \"custom_field,custom_field.asana_created_field,custom_field.created_by,custom_field.created_by.name,custom_field.currency_code,custom_field.custom_label,custom_field.custom_label_position,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.default_access_level,custom_field.description,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.format,custom_field.has_notifications_enabled,custom_field.html_text_value,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_global_to_workspace,custom_field.is_lookup_field,custom_field.is_value_read_only,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.people_value,custom_field.people_value.name,custom_field.precision,custom_field.privacy_setting,custom_field.reference_value,custom_field.reference_value.name,custom_field.representation_type,custom_field.resource_subtype,custom_field.text_value,custom_field.type,is_important,offset,parent,parent.name,parent.resource_subtype,path,project,project.name,project.resource_subtype,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a project's custom fields\n    api_response = custom_field_settings_api_instance.get_custom_field_settings_for_project(project_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling CustomFieldSettingsApi->get_custom_field_settings_for_project: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.custom_field_settings.get_custom_field_settings_for_project(project_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->customfieldsettings->getCustomFieldSettingsForProject($project_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.custom_field_settings.get_custom_field_settings_for_project(project_gid: 'project_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/project_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/projects/{project_gid}/duplicate": {
      "parameters": [
        {
          "$ref": "#/components/parameters/project_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/projects/{project_gid}/project_briefs": {
      "parameters": [
        {
          "$ref": "#/components/parameters/project_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "Creates a new project brief.\n\nReturns the full record of the newly created project brief.",
        "operationId": "createProjectBrief",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "html_text",
              "permalink_url",
              "project",
              "project.name",
              "project.resource_subtype",
              "text",
              "title"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "html_text",
                  "permalink_url",
                  "project",
                  "project.name",
                  "project.resource_subtype",
                  "text",
                  "title"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/ProjectBriefRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The project brief to create.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/ProjectBriefResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ProjectBriefResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created a new project brief."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Create a project brief",
        "tags": [
          "Project briefs"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1projects~1{project_gid}~1project_briefs/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.projectbriefs.createProjectBrief(projectGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectBriefsApiInstance = new Asana.ProjectBriefsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The project brief to create.\nlet project_gid = \"1331\"; // String | Globally unique identifier for the project.\nlet opts = { \n    'opt_fields': \"html_text,permalink_url,project,project.name,project.resource_subtype,text,title\"\n};\nprojectBriefsApiInstance.createProjectBrief(body, project_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projectbriefs.createProjectBrief(projectGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nproject_briefs_api_instance = asana.ProjectBriefsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The project brief to create.\nproject_gid = \"1331\" # str | Globally unique identifier for the project.\nopts = {\n    'opt_fields': \"html_text,permalink_url,project,project.name,project.resource_subtype,text,title\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create a project brief\n    api_response = project_briefs_api_instance.create_project_brief(body, project_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectBriefsApi->create_project_brief: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.project_briefs.create_project_brief(project_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projectbriefs->createProjectBrief($project_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.project_briefs.create_project_brief(project_gid: 'project_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/projects/{project_gid}/project_memberships": {
      "get": {
        "description": "Returns the compact project membership records for the project.",
        "operationId": "getProjectMembershipsForProject",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "access_level",
              "member",
              "member.name",
              "offset",
              "parent",
              "parent.name",
              "parent.resource_subtype",
              "path",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "access_level",
                  "member",
                  "member.name",
                  "offset",
                  "parent",
                  "parent.name",
                  "parent.resource_subtype",
                  "path",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/ProjectMembershipCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ProjectMembershipCompactArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested project's memberships."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get memberships from a project",
        "tags": [
          "Project memberships"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1projects~1{project_gid}~1project_memberships/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<ProjectMembership> result = client.projectmemberships.getProjectMembershipsForProject(projectGid, user)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectMembershipsApiInstance = new Asana.ProjectMembershipsApi(client);\nlet project_gid = \"1331\"; // String | Globally unique identifier for the project.\nlet opts = { \n    'user': \"me\", \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"access_level,member,member.name,offset,parent,parent.name,parent.resource_subtype,path,uri\"\n};\nprojectMembershipsApiInstance.getProjectMembershipsForProject(project_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projectmemberships.getProjectMembershipsForProject(projectGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nproject_memberships_api_instance = asana.ProjectMembershipsApi(api_client)\nproject_gid = \"1331\" # str | Globally unique identifier for the project.\nopts = {\n    'user': \"me\", # str | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\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    'opt_fields': \"access_level,member,member.name,offset,parent,parent.name,parent.resource_subtype,path,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get memberships from a project\n    api_response = project_memberships_api_instance.get_project_memberships_for_project(project_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectMembershipsApi->get_project_memberships_for_project: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.project_memberships.get_project_memberships_for_project(project_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projectmemberships->getProjectMembershipsForProject($project_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.project_memberships.get_project_memberships_for_project(project_gid: 'project_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/project_path_gid"
        },
        {
          "$ref": "#/components/parameters/user_query_param"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/projects/{project_gid}/project_portfolio_settings": {
      "get": {
        "description": "<b>Required scope: </b><code>project_portfolio_settings:read</code>\n\nReturns a compact representation of all of the project portfolio settings for the given project.",
        "operationId": "getProjectPortfolioSettingsForProject",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_at",
              "is_access_control_inherited",
              "offset",
              "path",
              "portfolio",
              "project",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_at",
                  "is_access_control_inherited",
                  "offset",
                  "path",
                  "portfolio",
                  "project",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/ProjectPortfolioSettingCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ProjectPortfolioSettingResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested project's project portfolio settings."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "project_portfolio_settings:read"
            ]
          }
        ],
        "summary": "Get project portfolio settings for a project",
        "tags": [
          "Project portfolio settings"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1projects~1{project_gid}~1project_portfolio_settings/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectPortfolioSettingsApiInstance = new Asana.ProjectPortfolioSettingsApi(client);\nlet project_gid = \"1331\"; // String | Globally unique identifier for the project.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"created_at,is_access_control_inherited,offset,path,portfolio,project,uri\"\n};\nprojectPortfolioSettingsApiInstance.getProjectPortfolioSettingsForProject(project_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nproject_portfolio_settings_api_instance = asana.ProjectPortfolioSettingsApi(api_client)\nproject_gid = \"1331\" # str | Globally unique identifier for the project.\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    'opt_fields': \"created_at,is_access_control_inherited,offset,path,portfolio,project,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get project portfolio settings for a project\n    api_response = project_portfolio_settings_api_instance.get_project_portfolio_settings_for_project(project_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectPortfolioSettingsApi->get_project_portfolio_settings_for_project: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/project_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/projects/{project_gid}/project_statuses": {
      "get": {
        "description": "*Deprecated: new integrations should prefer the `/status_updates` route.*\n\nReturns the compact project status update records for all updates on the project.",
        "operationId": "getProjectStatusesForProject",
        "parameters": [
          {
            "$ref": "#/components/parameters/project_path_gid"
          },
          {
            "$ref": "#/components/parameters/pretty"
          },
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "author",
              "author.name",
              "color",
              "created_at",
              "created_by",
              "created_by.name",
              "html_text",
              "modified_at",
              "offset",
              "path",
              "text",
              "title",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "author",
                  "author.name",
                  "color",
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "html_text",
                  "modified_at",
                  "offset",
                  "path",
                  "text",
                  "title",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/ProjectStatusCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ProjectStatusResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the specified project's status updates."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get statuses from a project",
        "tags": [
          "Project statuses"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1projects~1{project_gid}~1project_statuses/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<ProjectStatus> result = client.projectstatuses.getProjectStatusesForProject(projectGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectStatusesApiInstance = new Asana.ProjectStatusesApi(client);\nlet project_gid = \"1331\"; // String | Globally unique identifier for the project.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"author,author.name,color,created_at,created_by,created_by.name,html_text,modified_at,offset,path,text,title,uri\"\n};\nprojectStatusesApiInstance.getProjectStatusesForProject(project_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projectstatuses.getProjectStatusesForProject(projectGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nproject_statuses_api_instance = asana.ProjectStatusesApi(api_client)\nproject_gid = \"1331\" # str | Globally unique identifier for the project.\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    'opt_fields': \"author,author.name,color,created_at,created_by,created_by.name,html_text,modified_at,offset,path,text,title,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get statuses from a project\n    api_response = project_statuses_api_instance.get_project_statuses_for_project(project_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectStatusesApi->get_project_statuses_for_project: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.project_statuses.get_project_statuses_for_project(project_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projectstatuses->getProjectStatusesForProject($project_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.project_statuses.get_project_statuses_for_project(project_gid: 'project_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/project_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "*Deprecated: new integrations should prefer the `/status_updates` route.*\n\nCreates a new status update on the project.\n\nReturns the full record of the newly created project status update.",
        "operationId": "createProjectStatusForProject",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "author",
              "author.name",
              "color",
              "created_at",
              "created_by",
              "created_by.name",
              "html_text",
              "modified_at",
              "text",
              "title"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "author",
                  "author.name",
                  "color",
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "html_text",
                  "modified_at",
                  "text",
                  "title"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/ProjectStatusRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The project status to create.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/ProjectStatusResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ProjectStatusResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created a new story."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Create a project status",
        "tags": [
          "Project statuses"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1projects~1{project_gid}~1project_statuses/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nProjectStatus result = client.projectstatuses.createProjectStatusForProject(projectGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectStatusesApiInstance = new Asana.ProjectStatusesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The project status to create.\nlet project_gid = \"1331\"; // String | Globally unique identifier for the project.\nlet opts = { \n    'opt_fields': \"author,author.name,color,created_at,created_by,created_by.name,html_text,modified_at,text,title\"\n};\nprojectStatusesApiInstance.createProjectStatusForProject(body, project_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projectstatuses.createProjectStatusForProject(projectGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nproject_statuses_api_instance = asana.ProjectStatusesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The project status to create.\nproject_gid = \"1331\" # str | Globally unique identifier for the project.\nopts = {\n    'opt_fields': \"author,author.name,color,created_at,created_by,created_by.name,html_text,modified_at,text,title\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create a project status\n    api_response = project_statuses_api_instance.create_project_status_for_project(body, project_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectStatusesApi->create_project_status_for_project: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.project_statuses.create_project_status_for_project(project_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projectstatuses->createProjectStatusForProject($project_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.project_statuses.create_project_status_for_project(project_gid: 'project_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/projects/{project_gid}/removeCustomFieldSetting": {
      "parameters": [
        {
          "$ref": "#/components/parameters/project_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>projects:write</code>\n\nRemoves a custom field setting from a project.",
        "operationId": "removeCustomFieldSettingForProject",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/RemoveCustomFieldSettingRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Information about the custom field setting being removed.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully removed the custom field from the project."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "projects:write"
            ]
          }
        ],
        "summary": "Remove a custom field from a project",
        "tags": [
          "Projects"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1projects~1{project_gid}~1removeCustomFieldSetting/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.projects.removeCustomFieldSettingForProject(projectGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectsApiInstance = new Asana.ProjectsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | Information about the custom field setting being removed.\nlet project_gid = \"1331\"; // String | Globally unique identifier for the project.\n\nprojectsApiInstance.removeCustomFieldSettingForProject(body, project_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projects.removeCustomFieldSettingForProject(projectGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | Information about the custom field setting being removed.\nproject_gid = \"1331\" # str | Globally unique identifier for the project.\n\n\ntry:\n    # Remove a custom field from a project\n    api_response = projects_api_instance.remove_custom_field_setting_for_project(body, project_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectsApi->remove_custom_field_setting_for_project: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.projects.remove_custom_field_setting_for_project(project_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projects->removeCustomFieldSettingForProject($project_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.projects.remove_custom_field_setting_for_project(project_gid: 'project_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/projects/{project_gid}/removeFollowers": {
      "parameters": [
        {
          "$ref": "#/components/parameters/project_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "Removes the specified list of users from following the project, this will not affect project membership status.\nReturns the updated project record.",
        "operationId": "removeFollowersForProject",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "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.default_access_level",
              "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.html_text_value",
              "custom_field_settings.custom_field.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_global_to_workspace",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.privacy_setting",
              "custom_field_settings.custom_field.reference_value",
              "custom_field_settings.custom_field.reference_value.name",
              "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.parent.resource_subtype",
              "custom_field_settings.project",
              "custom_field_settings.project.name",
              "custom_field_settings.project.resource_subtype",
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "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",
              "resource_subtype",
              "start_on",
              "team",
              "team.name",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "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.default_access_level",
                  "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.html_text_value",
                  "custom_field_settings.custom_field.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_global_to_workspace",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.privacy_setting",
                  "custom_field_settings.custom_field.reference_value",
                  "custom_field_settings.custom_field.reference_value.name",
                  "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.parent.resource_subtype",
                  "custom_field_settings.project",
                  "custom_field_settings.project.name",
                  "custom_field_settings.project.resource_subtype",
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "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",
                  "resource_subtype",
                  "start_on",
                  "team",
                  "team.name",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/RemoveFollowersRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Information about the followers being removed.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/ProjectResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ProjectResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully removed followers from the project."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Remove followers from a project",
        "tags": [
          "Projects"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1projects~1{project_gid}~1removeFollowers/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nProject result = client.projects.removeFollowersForProject(projectGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectsApiInstance = new Asana.ProjectsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | Information about the followers being removed.\nlet project_gid = \"1331\"; // String | Globally unique identifier for the project.\nlet opts = { \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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,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,resource_subtype,start_on,team,team.name,workspace,workspace.name\"\n};\nprojectsApiInstance.removeFollowersForProject(body, project_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projects.removeFollowersForProject(projectGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | Information about the followers being removed.\nproject_gid = \"1331\" # str | Globally unique identifier for the project.\nopts = {\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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,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,resource_subtype,start_on,team,team.name,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Remove followers from a project\n    api_response = projects_api_instance.remove_followers_for_project(body, project_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectsApi->remove_followers_for_project: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.projects.remove_followers_for_project(project_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projects->removeFollowersForProject($project_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.projects.remove_followers_for_project(project_gid: 'project_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/projects/{project_gid}/removeMembers": {
      "parameters": [
        {
          "$ref": "#/components/parameters/project_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "Removes the specified list of users from members of the project.\nReturns the updated project record.",
        "operationId": "removeMembersForProject",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "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.default_access_level",
              "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.html_text_value",
              "custom_field_settings.custom_field.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_global_to_workspace",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.privacy_setting",
              "custom_field_settings.custom_field.reference_value",
              "custom_field_settings.custom_field.reference_value.name",
              "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.parent.resource_subtype",
              "custom_field_settings.project",
              "custom_field_settings.project.name",
              "custom_field_settings.project.resource_subtype",
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "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",
              "resource_subtype",
              "start_on",
              "team",
              "team.name",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "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.default_access_level",
                  "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.html_text_value",
                  "custom_field_settings.custom_field.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_global_to_workspace",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.privacy_setting",
                  "custom_field_settings.custom_field.reference_value",
                  "custom_field_settings.custom_field.reference_value.name",
                  "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.parent.resource_subtype",
                  "custom_field_settings.project",
                  "custom_field_settings.project.name",
                  "custom_field_settings.project.resource_subtype",
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "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",
                  "resource_subtype",
                  "start_on",
                  "team",
                  "team.name",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/RemoveMembersRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Information about the members being removed.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/ProjectResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ProjectResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully removed the members from the project."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Remove users from a project",
        "tags": [
          "Projects"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1projects~1{project_gid}~1removeMembers/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nProject result = client.projects.removeMembersForProject(projectGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectsApiInstance = new Asana.ProjectsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | Information about the members being removed.\nlet project_gid = \"1331\"; // String | Globally unique identifier for the project.\nlet opts = { \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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,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,resource_subtype,start_on,team,team.name,workspace,workspace.name\"\n};\nprojectsApiInstance.removeMembersForProject(body, project_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projects.removeMembersForProject(projectGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | Information about the members being removed.\nproject_gid = \"1331\" # str | Globally unique identifier for the project.\nopts = {\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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,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,resource_subtype,start_on,team,team.name,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Remove users from a project\n    api_response = projects_api_instance.remove_members_for_project(body, project_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectsApi->remove_members_for_project: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.projects.remove_members_for_project(project_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projects->removeMembersForProject($project_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.projects.remove_members_for_project(project_gid: 'project_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/projects/{project_gid}/rollup": {
      "parameters": [
        {
          "$ref": "#/components/parameters/project_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>projects:write</code>\n\nCreates and returns a job that will asynchronously roll up subtask dates for tasks in the project with the given `project_gid` whose descendant dates fall outside their current date range. Each parent task's start and due dates are reconciled to cover its descendants' date range.",
        "operationId": "rollupProject",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "dates_rollup_progress",
              "dates_rollup_progress.total_tasks",
              "dates_rollup_progress.updated_tasks",
              "new_graph_export",
              "new_graph_export.completed_at",
              "new_graph_export.created_at",
              "new_graph_export.download_url",
              "new_portfolio",
              "new_portfolio.name",
              "new_portfolio.resource_subtype",
              "new_project",
              "new_project.name",
              "new_project.resource_subtype",
              "new_project_template",
              "new_project_template.name",
              "new_resource_export",
              "new_resource_export.completed_at",
              "new_resource_export.created_at",
              "new_resource_export.download_url",
              "new_task",
              "new_task.created_by",
              "new_task.name",
              "new_task.resource_subtype",
              "resource_subtype",
              "status"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "dates_rollup_progress",
                  "dates_rollup_progress.total_tasks",
                  "dates_rollup_progress.updated_tasks",
                  "new_graph_export",
                  "new_graph_export.completed_at",
                  "new_graph_export.created_at",
                  "new_graph_export.download_url",
                  "new_portfolio",
                  "new_portfolio.name",
                  "new_portfolio.resource_subtype",
                  "new_project",
                  "new_project.name",
                  "new_project.resource_subtype",
                  "new_project_template",
                  "new_project_template.name",
                  "new_resource_export",
                  "new_resource_export.completed_at",
                  "new_resource_export.created_at",
                  "new_resource_export.download_url",
                  "new_task",
                  "new_task.created_by",
                  "new_task.name",
                  "new_task.resource_subtype",
                  "resource_subtype",
                  "status"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/JobResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__JobResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created a job to roll up the project's subtask dates."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "projects:write"
            ]
          }
        ],
        "summary": "Roll up subtask dates for a project",
        "tags": [
          "Projects"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1projects~1{project_gid}~1rollup/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectsApiInstance = new Asana.ProjectsApi(client);\nlet project_gid = \"1331\"; // String | Globally unique identifier for the project.\nlet opts = { \n    'opt_fields': \"dates_rollup_progress,dates_rollup_progress.total_tasks,dates_rollup_progress.updated_tasks,new_graph_export,new_graph_export.completed_at,new_graph_export.created_at,new_graph_export.download_url,new_portfolio,new_portfolio.name,new_portfolio.resource_subtype,new_project,new_project.name,new_project.resource_subtype,new_project_template,new_project_template.name,new_resource_export,new_resource_export.completed_at,new_resource_export.created_at,new_resource_export.download_url,new_task,new_task.created_by,new_task.name,new_task.resource_subtype,resource_subtype,status\"\n};\nprojectsApiInstance.rollupProject(project_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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)\nproject_gid = \"1331\" # str | Globally unique identifier for the project.\nopts = {\n    'opt_fields': \"dates_rollup_progress,dates_rollup_progress.total_tasks,dates_rollup_progress.updated_tasks,new_graph_export,new_graph_export.completed_at,new_graph_export.created_at,new_graph_export.download_url,new_portfolio,new_portfolio.name,new_portfolio.resource_subtype,new_project,new_project.name,new_project.resource_subtype,new_project_template,new_project_template.name,new_resource_export,new_resource_export.completed_at,new_resource_export.created_at,new_resource_export.download_url,new_task,new_task.created_by,new_task.name,new_task.resource_subtype,resource_subtype,status\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Roll up subtask dates for a project\n    api_response = projects_api_instance.rollup_project(project_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectsApi->rollup_project: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/projects/{project_gid}/saveAsTemplate": {
      "parameters": [
        {
          "$ref": "#/components/parameters/project_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "Creates and returns a job that will asynchronously handle the project template creation.",
        "operationId": "projectSaveAsTemplate",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "dates_rollup_progress",
              "dates_rollup_progress.total_tasks",
              "dates_rollup_progress.updated_tasks",
              "new_graph_export",
              "new_graph_export.completed_at",
              "new_graph_export.created_at",
              "new_graph_export.download_url",
              "new_portfolio",
              "new_portfolio.name",
              "new_portfolio.resource_subtype",
              "new_project",
              "new_project.name",
              "new_project.resource_subtype",
              "new_project_template",
              "new_project_template.name",
              "new_resource_export",
              "new_resource_export.completed_at",
              "new_resource_export.created_at",
              "new_resource_export.download_url",
              "new_task",
              "new_task.created_by",
              "new_task.name",
              "new_task.resource_subtype",
              "resource_subtype",
              "status"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "dates_rollup_progress",
                  "dates_rollup_progress.total_tasks",
                  "dates_rollup_progress.updated_tasks",
                  "new_graph_export",
                  "new_graph_export.completed_at",
                  "new_graph_export.created_at",
                  "new_graph_export.download_url",
                  "new_portfolio",
                  "new_portfolio.name",
                  "new_portfolio.resource_subtype",
                  "new_project",
                  "new_project.name",
                  "new_project.resource_subtype",
                  "new_project_template",
                  "new_project_template.name",
                  "new_resource_export",
                  "new_resource_export.completed_at",
                  "new_resource_export.created_at",
                  "new_resource_export.download_url",
                  "new_task",
                  "new_task.created_by",
                  "new_task.name",
                  "new_task.resource_subtype",
                  "resource_subtype",
                  "status"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/ProjectSaveAsTemplateRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Describes the inputs used for creating a project template, such as the resulting project template's name, which team it should be created in.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/JobResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__JobResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created the job to handle project template creation."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Create a project template from a project",
        "tags": [
          "Projects"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1projects~1{project_gid}~1saveAsTemplate/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJob result = client.projects.projectSaveAsTemplate(projectGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectsApiInstance = new Asana.ProjectsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | Describes the inputs used for creating a project template, such as the resulting project template's name, which team it should be created in.\nlet project_gid = \"1331\"; // String | Globally unique identifier for the project.\nlet opts = { \n    'opt_fields': \"dates_rollup_progress,dates_rollup_progress.total_tasks,dates_rollup_progress.updated_tasks,new_graph_export,new_graph_export.completed_at,new_graph_export.created_at,new_graph_export.download_url,new_portfolio,new_portfolio.name,new_portfolio.resource_subtype,new_project,new_project.name,new_project.resource_subtype,new_project_template,new_project_template.name,new_resource_export,new_resource_export.completed_at,new_resource_export.created_at,new_resource_export.download_url,new_task,new_task.created_by,new_task.name,new_task.resource_subtype,resource_subtype,status\"\n};\nprojectsApiInstance.projectSaveAsTemplate(body, project_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projects.projectSaveAsTemplate(projectGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | Describes the inputs used for creating a project template, such as the resulting project template's name, which team it should be created in.\nproject_gid = \"1331\" # str | Globally unique identifier for the project.\nopts = {\n    'opt_fields': \"dates_rollup_progress,dates_rollup_progress.total_tasks,dates_rollup_progress.updated_tasks,new_graph_export,new_graph_export.completed_at,new_graph_export.created_at,new_graph_export.download_url,new_portfolio,new_portfolio.name,new_portfolio.resource_subtype,new_project,new_project.name,new_project.resource_subtype,new_project_template,new_project_template.name,new_resource_export,new_resource_export.completed_at,new_resource_export.created_at,new_resource_export.download_url,new_task,new_task.created_by,new_task.name,new_task.resource_subtype,resource_subtype,status\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create a project template from a project\n    api_response = projects_api_instance.project_save_as_template(body, project_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectsApi->project_save_as_template: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.projects.project_save_as_template(project_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projects->projectSaveAsTemplate($project_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.projects.project_save_as_template(project_gid: 'project_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/projects/{project_gid}/sections": {
      "get": {
        "description": "<b>Required scope: </b><code>projects:read</code>\n\nReturns the compact records for all sections in the specified project.",
        "operationId": "getSectionsForProject",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_at",
              "name",
              "offset",
              "path",
              "project",
              "project.name",
              "project.resource_subtype",
              "projects",
              "projects.name",
              "projects.resource_subtype",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_at",
                  "name",
                  "offset",
                  "path",
                  "project",
                  "project.name",
                  "project.resource_subtype",
                  "projects",
                  "projects.name",
                  "projects.resource_subtype",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/SectionCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__SectionResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved sections in project."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "projects:read"
            ]
          }
        ],
        "summary": "Get sections in a project",
        "tags": [
          "Sections"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1projects~1{project_gid}~1sections/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Section> result = client.sections.getSectionsForProject(projectGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet sectionsApiInstance = new Asana.SectionsApi(client);\nlet project_gid = \"1331\"; // String | Globally unique identifier for the project.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"created_at,name,offset,path,project,project.name,project.resource_subtype,projects,projects.name,projects.resource_subtype,uri\"\n};\nsectionsApiInstance.getSectionsForProject(project_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.sections.getSectionsForProject(projectGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nsections_api_instance = asana.SectionsApi(api_client)\nproject_gid = \"1331\" # str | Globally unique identifier for the project.\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    'opt_fields': \"created_at,name,offset,path,project,project.name,project.resource_subtype,projects,projects.name,projects.resource_subtype,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get sections in a project\n    api_response = sections_api_instance.get_sections_for_project(project_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling SectionsApi->get_sections_for_project: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.sections.get_sections_for_project(project_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->sections->getSectionsForProject($project_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.sections.get_sections_for_project(project_gid: 'project_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/project_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>projects:write</code>\n\nCreates a new section in a project.\nReturns the full record of the newly created section.",
        "operationId": "createSectionForProject",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_at",
              "name",
              "project",
              "project.name",
              "project.resource_subtype",
              "projects",
              "projects.name",
              "projects.resource_subtype"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_at",
                  "name",
                  "project",
                  "project.name",
                  "project.resource_subtype",
                  "projects",
                  "projects.name",
                  "projects.resource_subtype"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/SectionRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The section to create."
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/SectionResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__SectionResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created the specified section."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "projects:write"
            ]
          }
        ],
        "summary": "Create a section in a project",
        "tags": [
          "Sections"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1projects~1{project_gid}~1sections/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nSection result = client.sections.createSectionForProject(projectGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet sectionsApiInstance = new Asana.SectionsApi(client);\nlet project_gid = \"1331\"; // String | Globally unique identifier for the project.\nlet opts = { \n    'body': {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}, \n    'opt_fields': \"created_at,name,project,project.name,project.resource_subtype,projects,projects.name,projects.resource_subtype\"\n};\nsectionsApiInstance.createSectionForProject(project_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.sections.createSectionForProject(projectGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nsections_api_instance = asana.SectionsApi(api_client)\nproject_gid = \"1331\" # str | Globally unique identifier for the project.\nopts = {\n    'body': {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}, # dict | The section to create.\n    'opt_fields': \"created_at,name,project,project.name,project.resource_subtype,projects,projects.name,projects.resource_subtype\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create a section in a project\n    api_response = sections_api_instance.create_section_for_project(project_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling SectionsApi->create_section_for_project: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.sections.create_section_for_project(project_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->sections->createSectionForProject($project_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.sections.create_section_for_project(project_gid: 'project_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/projects/{project_gid}/sections/insert": {
      "parameters": [
        {
          "$ref": "#/components/parameters/project_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>projects:write</code>\n\nMove sections relative to each other. One of\n`before_section` or `after_section` is required.\n\nSections cannot be moved between projects.\n\nReturns an empty data block.",
        "operationId": "insertSectionForProject",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/ProjectSectionInsertRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The section's move action."
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully moved the specified section."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "projects:write"
            ]
          }
        ],
        "summary": "Move or Insert sections",
        "tags": [
          "Sections"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1projects~1{project_gid}~1sections~1insert/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.sections.insertSectionForProject(projectGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet sectionsApiInstance = new Asana.SectionsApi(client);\nlet project_gid = \"1331\"; // String | Globally unique identifier for the project.\nlet opts = { \n    'body': {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}\n};\nsectionsApiInstance.insertSectionForProject(project_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.sections.insertSectionForProject(projectGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nsections_api_instance = asana.SectionsApi(api_client)\nproject_gid = \"1331\" # str | Globally unique identifier for the project.\nopts = {\n    'body': {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}, # dict | The section's move action.\n}\n\ntry:\n    # Move or Insert sections\n    api_response = sections_api_instance.insert_section_for_project(project_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling SectionsApi->insert_section_for_project: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.sections.insert_section_for_project(project_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->sections->insertSectionForProject($project_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.sections.insert_section_for_project(project_gid: 'project_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/projects/{project_gid}/task_counts": {
      "get": {
        "description": "<b>Required scope: </b><code>projects:read</code>\n\n<table>\n  <tr>\n    <th>Field</th>\n    <th>Required Scope</th>\n  </tr>\n  <tr>\n    <td><code>team</code></td>\n    <td><code>teams:read</code></td>\n  </tr>\n  <tr>\n    <td><code>custom_type</code></td>\n    <td><code>custom_types:read</code></td>\n  </tr>\n</table>\n\nGet an object that holds task count fields. **All fields are excluded by default**. You must [opt in](/docs/inputoutput-options) using `opt_fields` to get any information from this endpoint.\n\nThis endpoint has an additional [rate limit](/docs/rate-limits) and each field counts especially high against our [cost limits](/docs/rate-limits#cost-limits).\n\nMilestones are just tasks, so they are included in the `num_tasks`, `num_incomplete_tasks`, and `num_completed_tasks` counts.",
        "operationId": "getTaskCountsForProject",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "num_completed_milestones",
              "num_completed_tasks",
              "num_incomplete_milestones",
              "num_incomplete_tasks",
              "num_milestones",
              "num_tasks"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "num_completed_milestones",
                  "num_completed_tasks",
                  "num_incomplete_milestones",
                  "num_incomplete_tasks",
                  "num_milestones",
                  "num_tasks"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TaskCountResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TaskCountResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested project's task counts."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "projects:read"
            ]
          }
        ],
        "summary": "Get task count of a project",
        "tags": [
          "Projects"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1projects~1{project_gid}~1task_counts/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.projects.getTaskCountsForProject(projectGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectsApiInstance = new Asana.ProjectsApi(client);\nlet project_gid = \"1331\"; // String | Globally unique identifier for the project.\nlet opts = { \n    'opt_fields': \"num_completed_milestones,num_completed_tasks,num_incomplete_milestones,num_incomplete_tasks,num_milestones,num_tasks\"\n};\nprojectsApiInstance.getTaskCountsForProject(project_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projects.getTaskCountsForProject(projectGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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)\nproject_gid = \"1331\" # str | Globally unique identifier for the project.\nopts = {\n    'opt_fields': \"num_completed_milestones,num_completed_tasks,num_incomplete_milestones,num_incomplete_tasks,num_milestones,num_tasks\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get task count of a project\n    api_response = projects_api_instance.get_task_counts_for_project(project_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectsApi->get_task_counts_for_project: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.projects.get_task_counts_for_project(project_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projects->getTaskCountsForProject($project_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.projects.get_task_counts_for_project(project_gid: 'project_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/project_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/projects/{project_gid}/tasks": {
      "get": {
        "description": "<b>Required scope: </b><code>tasks:read</code>\n\nReturns the compact task records for all tasks within the given project, ordered by their priority within the project. Tasks can exist in more than one project at a time.",
        "operationId": "getTasksForProject",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "actual_time_minutes",
              "approval_status",
              "assigned_by",
              "assigned_by.name",
              "assignee",
              "assignee.name",
              "assignee_section",
              "assignee_section.name",
              "assignee_status",
              "completed",
              "completed_at",
              "completed_by",
              "completed_by.name",
              "created_at",
              "created_by",
              "custom_fields",
              "custom_fields.asana_created_field",
              "custom_fields.created_by",
              "custom_fields.created_by.name",
              "custom_fields.currency_code",
              "custom_fields.custom_label",
              "custom_fields.custom_label_position",
              "custom_fields.date_value",
              "custom_fields.date_value.date",
              "custom_fields.date_value.date_time",
              "custom_fields.default_access_level",
              "custom_fields.description",
              "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.format",
              "custom_fields.has_notifications_enabled",
              "custom_fields.html_text_value",
              "custom_fields.id_prefix",
              "custom_fields.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_global_to_workspace",
              "custom_fields.is_lookup_field",
              "custom_fields.is_value_read_only",
              "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.people_value",
              "custom_fields.people_value.name",
              "custom_fields.precision",
              "custom_fields.privacy_setting",
              "custom_fields.reference_value",
              "custom_fields.reference_value.name",
              "custom_fields.representation_type",
              "custom_fields.resource_subtype",
              "custom_fields.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "custom_type_status_option",
              "custom_type_status_option.name",
              "dependencies",
              "dependents",
              "due_at",
              "due_on",
              "effective_memberships",
              "external",
              "external.data",
              "followers",
              "followers.name",
              "has_subtasks_date_mismatch",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_notes",
              "is_rendered_as_separator",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "memberships",
              "memberships.project",
              "memberships.project.name",
              "memberships.project.resource_subtype",
              "memberships.section",
              "memberships.section.name",
              "modified_at",
              "name",
              "notes",
              "num_hearts",
              "num_likes",
              "num_subtasks",
              "offset",
              "parent",
              "parent.created_by",
              "parent.name",
              "parent.resource_subtype",
              "path",
              "permalink_url",
              "projects",
              "projects.name",
              "projects.resource_subtype",
              "resource_subtype",
              "start_at",
              "start_on",
              "tags",
              "tags.name",
              "uri",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "actual_time_minutes",
                  "approval_status",
                  "assigned_by",
                  "assigned_by.name",
                  "assignee",
                  "assignee.name",
                  "assignee_section",
                  "assignee_section.name",
                  "assignee_status",
                  "completed",
                  "completed_at",
                  "completed_by",
                  "completed_by.name",
                  "created_at",
                  "created_by",
                  "custom_fields",
                  "custom_fields.asana_created_field",
                  "custom_fields.created_by",
                  "custom_fields.created_by.name",
                  "custom_fields.currency_code",
                  "custom_fields.custom_label",
                  "custom_fields.custom_label_position",
                  "custom_fields.date_value",
                  "custom_fields.date_value.date",
                  "custom_fields.date_value.date_time",
                  "custom_fields.default_access_level",
                  "custom_fields.description",
                  "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.format",
                  "custom_fields.has_notifications_enabled",
                  "custom_fields.html_text_value",
                  "custom_fields.id_prefix",
                  "custom_fields.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_global_to_workspace",
                  "custom_fields.is_lookup_field",
                  "custom_fields.is_value_read_only",
                  "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.people_value",
                  "custom_fields.people_value.name",
                  "custom_fields.precision",
                  "custom_fields.privacy_setting",
                  "custom_fields.reference_value",
                  "custom_fields.reference_value.name",
                  "custom_fields.representation_type",
                  "custom_fields.resource_subtype",
                  "custom_fields.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "custom_type_status_option",
                  "custom_type_status_option.name",
                  "dependencies",
                  "dependents",
                  "due_at",
                  "due_on",
                  "effective_memberships",
                  "external",
                  "external.data",
                  "followers",
                  "followers.name",
                  "has_subtasks_date_mismatch",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_notes",
                  "is_rendered_as_separator",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "memberships",
                  "memberships.project",
                  "memberships.project.name",
                  "memberships.project.resource_subtype",
                  "memberships.section",
                  "memberships.section.name",
                  "modified_at",
                  "name",
                  "notes",
                  "num_hearts",
                  "num_likes",
                  "num_subtasks",
                  "offset",
                  "parent",
                  "parent.created_by",
                  "parent.name",
                  "parent.resource_subtype",
                  "path",
                  "permalink_url",
                  "projects",
                  "projects.name",
                  "projects.resource_subtype",
                  "resource_subtype",
                  "start_at",
                  "start_on",
                  "tags",
                  "tags.name",
                  "uri",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TaskCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TaskResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested project's tasks."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:read"
            ]
          }
        ],
        "summary": "Get tasks from a project",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1projects~1{project_gid}~1tasks/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Task> result = client.tasks.getTasksForProject(projectGid, completedSince)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet project_gid = \"1331\"; // String | Globally unique identifier for the project.\nlet opts = { \n    'completed_since': \"2012-02-22T02:06:58.158Z\", \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,offset,parent,parent.created_by,parent.name,parent.resource_subtype,path,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,uri,workspace,workspace.name\"\n};\ntasksApiInstance.getTasksForProject(project_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.getTasksForProject(projectGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\nproject_gid = \"1331\" # str | Globally unique identifier for the project.\nopts = {\n    'completed_since': \"2012-02-22T02:06:58.158Z\", # str | Only return tasks that are either incomplete or that have been completed since this time. Accepts a date-time string or the keyword *now*. \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    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,offset,parent,parent.created_by,parent.name,parent.resource_subtype,path,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,uri,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get tasks from a project\n    api_response = tasks_api_instance.get_tasks_for_project(project_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->get_tasks_for_project: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.get_tasks_for_project(project_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->getTasksForProject($project_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.get_tasks_for_project(project_gid: 'project_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/completed_since"
        },
        {
          "$ref": "#/components/parameters/project_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/rates": {
      "get": {
        "description": "Returns a list of `rate` records. The possible types for `parent` in this request are `project`. An additional `resource` (`user` GID or `placeholder` GID) can be passed in to filter to a specific rate.\n\nModifying placeholder rates is only available for Enterprise and Enterprise+ users.",
        "operationId": "getRates",
        "parameters": [
          {
            "description": "Globally unique identifier for `project`.",
            "example": "159874",
            "in": "query",
            "name": "parent",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Globally unique identifier for `user` or `placeholder`.",
            "example": "1061493",
            "in": "query",
            "name": "resource",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "offset",
              "path",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "offset",
                  "path",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/RateOrPlaceholderCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__RateOrPlaceholderCompactArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested rates."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get multiple rates",
        "tags": [
          "Rates"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1rates/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet ratesApiInstance = new Asana.RatesApi(client);\nlet opts = { \n    'parent': \"159874\", \n    'resource': \"1061493\", \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"offset,path,uri\"\n};\nratesApiInstance.getRates(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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nrates_api_instance = asana.RatesApi(api_client)\nopts = {\n    'parent': \"159874\", # str | Globally unique identifier for `project`.\n    'resource': \"1061493\", # str | Globally unique identifier for `user` or `placeholder`.\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    'opt_fields': \"offset,path,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get multiple rates\n    api_response = rates_api_instance.get_rates(opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling RatesApi->get_rates: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "Creates a new rate for a `parent` + `resource` combination.",
        "operationId": "createRate",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_by",
              "created_by.name",
              "currency_code",
              "parent",
              "parent.name",
              "parent.resource_subtype",
              "rate",
              "resource",
              "resource.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_by",
                  "created_by.name",
                  "currency_code",
                  "parent",
                  "parent.name",
                  "parent.resource_subtype",
                  "rate",
                  "resource",
                  "resource.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/RateRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The rate to create.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/RateResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__RateResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created a new rate."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Create a rate",
        "tags": [
          "Rates"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1rates/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet ratesApiInstance = new Asana.RatesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The rate to create.\nlet opts = { \n    'opt_fields': \"created_by,created_by.name,currency_code,parent,parent.name,parent.resource_subtype,rate,resource,resource.name\"\n};\nratesApiInstance.createRate(body, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nrates_api_instance = asana.RatesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The rate to create.\nopts = {\n    'opt_fields': \"created_by,created_by.name,currency_code,parent,parent.name,parent.resource_subtype,rate,resource,resource.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create a rate\n    api_response = rates_api_instance.create_rate(body, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling RatesApi->create_rate: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/rates/{rate_gid}": {
      "delete": {
        "description": "Deletes a rate.",
        "operationId": "deleteRate",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully deleted the rate."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Delete a rate",
        "tags": [
          "Rates"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1rates~1{rate_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet ratesApiInstance = new Asana.RatesApi(client);\nlet rate_gid = \"12345\"; // String | Globally unique identifier for the rate.\n\nratesApiInstance.deleteRate(rate_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nrates_api_instance = asana.RatesApi(api_client)\nrate_gid = \"12345\" # str | Globally unique identifier for the rate.\n\n\ntry:\n    # Delete a rate\n    api_response = rates_api_instance.delete_rate(rate_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling RatesApi->delete_rate: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "get": {
        "description": "Returns the complete rate record for a single rate.",
        "operationId": "getRate",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_by",
              "created_by.name",
              "currency_code",
              "parent",
              "parent.name",
              "parent.resource_subtype",
              "rate",
              "resource",
              "resource.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_by",
                  "created_by.name",
                  "currency_code",
                  "parent",
                  "parent.name",
                  "parent.resource_subtype",
                  "rate",
                  "resource",
                  "resource.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/RateResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__RateResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the record for a single rate."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get a rate",
        "tags": [
          "Rates"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1rates~1{rate_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet ratesApiInstance = new Asana.RatesApi(client);\nlet rate_gid = \"12345\"; // String | Globally unique identifier for the rate.\nlet opts = { \n    'opt_fields': \"created_by,created_by.name,currency_code,parent,parent.name,parent.resource_subtype,rate,resource,resource.name\"\n};\nratesApiInstance.getRate(rate_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nrates_api_instance = asana.RatesApi(api_client)\nrate_gid = \"12345\" # str | Globally unique identifier for the rate.\nopts = {\n    'opt_fields': \"created_by,created_by.name,currency_code,parent,parent.name,parent.resource_subtype,rate,resource,resource.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a rate\n    api_response = rates_api_instance.get_rate(rate_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling RatesApi->get_rate: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/rate_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "put": {
        "description": "An existing rate can be updated by making a PUT request on the URL for\nthat rate. Only the fields provided in the `data` block will be updated;\nany unspecified fields will remain unchanged. (note that at this time, the only field that can be updated is the `rate` field.)\n\nReturns the complete updated rate record.",
        "operationId": "updateRate",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_by",
              "created_by.name",
              "currency_code",
              "parent",
              "parent.name",
              "parent.resource_subtype",
              "rate",
              "resource",
              "resource.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_by",
                  "created_by.name",
                  "currency_code",
                  "parent",
                  "parent.name",
                  "parent.resource_subtype",
                  "rate",
                  "resource",
                  "resource.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/RateUpdateRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The updated fields for the rate.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/RateResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__RateResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully updated the rate."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Update a rate",
        "tags": [
          "Rates"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1rates~1{rate_gid}/put",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet ratesApiInstance = new Asana.RatesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The updated fields for the rate.\nlet rate_gid = \"12345\"; // String | Globally unique identifier for the rate.\nlet opts = { \n    'opt_fields': \"created_by,created_by.name,currency_code,parent,parent.name,parent.resource_subtype,rate,resource,resource.name\"\n};\nratesApiInstance.updateRate(body, rate_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nrates_api_instance = asana.RatesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The updated fields for the rate.\nrate_gid = \"12345\" # str | Globally unique identifier for the rate.\nopts = {\n    'opt_fields': \"created_by,created_by.name,currency_code,parent,parent.name,parent.resource_subtype,rate,resource,resource.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Update a rate\n    api_response = rates_api_instance.update_rate(body, rate_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling RatesApi->update_rate: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/reactions": {
      "get": {
        "description": "Returns the reactions with a specified emoji base character on the object.",
        "operationId": "getReactionsOnObject",
        "parameters": [
          {
            "description": "Globally unique identifier for object to fetch reactions from. Must be a GID for a status update or story.",
            "example": "159874",
            "in": "query",
            "name": "target",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Only return reactions with this emoji base character.",
            "example": "👍",
            "in": "query",
            "name": "emoji_base",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/ReactionCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ReactionCompactArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the specified object's reactions."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get reactions with an emoji base on an object.",
        "tags": [
          "Reactions"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1reactions/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet reactionsApiInstance = new Asana.ReactionsApi(client);\nlet target = \"159874\"; // String | Globally unique identifier for object to fetch reactions from. Must be a GID for a status update or story.\nlet emoji_base = \"👍\"; // String | Only return reactions with this emoji base character.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\"\n};\nreactionsApiInstance.getReactionsOnObject(target, emoji_base, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nreactions_api_instance = asana.ReactionsApi(api_client)\ntarget = \"159874\" # str | Globally unique identifier for object to fetch reactions from. Must be a GID for a status update or story.\nemoji_base = \"👍\" # str | Only return reactions with this emoji base character.\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}\n\ntry:\n    # Get reactions with an emoji base on an object.\n    api_response = reactions_api_instance.get_reactions_on_object(target, emoji_base, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling ReactionsApi->get_reactions_on_object: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/records": {
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/records/{record_gid}": {
      "delete": {
        "description": "<b>Required scope: </b><code>records:delete</code>\n\nA specific, existing record can be deleted by making a DELETE request\non the URL for that record.\n\nReturns an empty data record.",
        "operationId": "deleteRecord",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully deleted the specified record."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "records:delete"
            ]
          }
        ],
        "summary": "Delete a record",
        "tags": [
          "Records"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1records~1{record_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet recordsApiInstance = new Asana.RecordsApi(client);\nlet record_gid = \"7331\"; // String | Globally unique identifier for the record.\n\nrecordsApiInstance.deleteRecord(record_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nrecords_api_instance = asana.RecordsApi(api_client)\nrecord_gid = \"7331\" # str | Globally unique identifier for the record.\n\n\ntry:\n    # Delete a record\n    api_response = records_api_instance.delete_record(record_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling RecordsApi->delete_record: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "get": {
        "description": "<b>Required scope: </b><code>records:read</code>\n\nReturns the complete record for a single record.",
        "operationId": "getRecord",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "comment_count",
              "created_at",
              "created_by",
              "created_by.name",
              "custom_fields",
              "custom_fields.asana_created_field",
              "custom_fields.created_by",
              "custom_fields.created_by.name",
              "custom_fields.currency_code",
              "custom_fields.custom_label",
              "custom_fields.custom_label_position",
              "custom_fields.date_value",
              "custom_fields.date_value.date",
              "custom_fields.date_value.date_time",
              "custom_fields.default_access_level",
              "custom_fields.description",
              "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.format",
              "custom_fields.has_notifications_enabled",
              "custom_fields.html_text_value",
              "custom_fields.id_prefix",
              "custom_fields.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_global_to_workspace",
              "custom_fields.is_lookup_field",
              "custom_fields.is_value_read_only",
              "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.people_value",
              "custom_fields.people_value.name",
              "custom_fields.precision",
              "custom_fields.privacy_setting",
              "custom_fields.reference_value",
              "custom_fields.reference_value.name",
              "custom_fields.representation_type",
              "custom_fields.resource_subtype",
              "custom_fields.text_value",
              "custom_fields.type",
              "default_access_level",
              "deleted_at",
              "is_in_archived_table",
              "modified_at",
              "name",
              "permalink_url",
              "table",
              "table.name",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "comment_count",
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "custom_fields",
                  "custom_fields.asana_created_field",
                  "custom_fields.created_by",
                  "custom_fields.created_by.name",
                  "custom_fields.currency_code",
                  "custom_fields.custom_label",
                  "custom_fields.custom_label_position",
                  "custom_fields.date_value",
                  "custom_fields.date_value.date",
                  "custom_fields.date_value.date_time",
                  "custom_fields.default_access_level",
                  "custom_fields.description",
                  "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.format",
                  "custom_fields.has_notifications_enabled",
                  "custom_fields.html_text_value",
                  "custom_fields.id_prefix",
                  "custom_fields.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_global_to_workspace",
                  "custom_fields.is_lookup_field",
                  "custom_fields.is_value_read_only",
                  "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.people_value",
                  "custom_fields.people_value.name",
                  "custom_fields.precision",
                  "custom_fields.privacy_setting",
                  "custom_fields.reference_value",
                  "custom_fields.reference_value.name",
                  "custom_fields.representation_type",
                  "custom_fields.resource_subtype",
                  "custom_fields.text_value",
                  "custom_fields.type",
                  "default_access_level",
                  "deleted_at",
                  "is_in_archived_table",
                  "modified_at",
                  "name",
                  "permalink_url",
                  "table",
                  "table.name",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/RecordItemResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__RecordItemResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested record."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "records:read"
            ]
          }
        ],
        "summary": "Get a record",
        "tags": [
          "Records"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1records~1{record_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet recordsApiInstance = new Asana.RecordsApi(client);\nlet record_gid = \"7331\"; // String | Globally unique identifier for the record.\nlet opts = { \n    'opt_fields': \"comment_count,created_at,created_by,created_by.name,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,deleted_at,is_in_archived_table,modified_at,name,permalink_url,table,table.name,workspace,workspace.name\"\n};\nrecordsApiInstance.getRecord(record_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nrecords_api_instance = asana.RecordsApi(api_client)\nrecord_gid = \"7331\" # str | Globally unique identifier for the record.\nopts = {\n    'opt_fields': \"comment_count,created_at,created_by,created_by.name,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,deleted_at,is_in_archived_table,modified_at,name,permalink_url,table,table.name,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a record\n    api_response = records_api_instance.get_record(record_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling RecordsApi->get_record: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/record_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/records/{record_gid}/stories": {
      "get": {
        "description": "<b>Required scope: </b><code>stories:read</code>\n\nReturns the compact records for all stories on the record.",
        "operationId": "getStoriesForRecord",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "$ref": "#/components/parameters/story_created_after"
          },
          {
            "$ref": "#/components/parameters/story_resource_subtype"
          },
          {
            "$ref": "#/components/parameters/story_sort_ascending"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "anchor_gid",
              "assignee",
              "assignee.name",
              "comment_gid",
              "created_at",
              "created_by",
              "created_by.name",
              "custom_field",
              "custom_field.date_value",
              "custom_field.date_value.date",
              "custom_field.date_value.date_time",
              "custom_field.display_value",
              "custom_field.enabled",
              "custom_field.enum_options",
              "custom_field.enum_options.color",
              "custom_field.enum_options.enabled",
              "custom_field.enum_options.name",
              "custom_field.enum_value",
              "custom_field.enum_value.color",
              "custom_field.enum_value.enabled",
              "custom_field.enum_value.name",
              "custom_field.id_prefix",
              "custom_field.input_restrictions",
              "custom_field.is_formula_field",
              "custom_field.is_lookup_field",
              "custom_field.multi_enum_values",
              "custom_field.multi_enum_values.color",
              "custom_field.multi_enum_values.enabled",
              "custom_field.multi_enum_values.name",
              "custom_field.name",
              "custom_field.number_value",
              "custom_field.representation_type",
              "custom_field.text_value",
              "custom_field.type",
              "dependency",
              "dependency.created_by",
              "dependency.name",
              "dependency.resource_subtype",
              "duplicate_of",
              "duplicate_of.created_by",
              "duplicate_of.name",
              "duplicate_of.resource_subtype",
              "duplicated_from",
              "duplicated_from.created_by",
              "duplicated_from.name",
              "duplicated_from.resource_subtype",
              "follower",
              "follower.name",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_text",
              "is_editable",
              "is_edited",
              "is_pinned",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "new_approval_status",
              "new_date_value",
              "new_dates",
              "new_dates.due_at",
              "new_dates.due_on",
              "new_dates.start_on",
              "new_enum_value",
              "new_enum_value.color",
              "new_enum_value.enabled",
              "new_enum_value.name",
              "new_multi_enum_values",
              "new_multi_enum_values.color",
              "new_multi_enum_values.enabled",
              "new_multi_enum_values.name",
              "new_name",
              "new_number_value",
              "new_people_value",
              "new_people_value.name",
              "new_resource_subtype",
              "new_section",
              "new_section.name",
              "new_text_value",
              "num_hearts",
              "num_likes",
              "offset",
              "old_approval_status",
              "old_date_value",
              "old_dates",
              "old_dates.due_at",
              "old_dates.due_on",
              "old_dates.start_on",
              "old_enum_value",
              "old_enum_value.color",
              "old_enum_value.enabled",
              "old_enum_value.name",
              "old_multi_enum_values",
              "old_multi_enum_values.color",
              "old_multi_enum_values.enabled",
              "old_multi_enum_values.name",
              "old_name",
              "old_number_value",
              "old_people_value",
              "old_people_value.name",
              "old_resource_subtype",
              "old_section",
              "old_section.name",
              "old_text_value",
              "path",
              "previews",
              "previews.fallback",
              "previews.footer",
              "previews.header",
              "previews.header_link",
              "previews.html_text",
              "previews.text",
              "previews.title",
              "previews.title_link",
              "project",
              "project.name",
              "project.resource_subtype",
              "reaction_summary",
              "reaction_summary.count",
              "reaction_summary.emoji_base",
              "reaction_summary.reacted",
              "reaction_summary.variant",
              "resource_subtype",
              "source",
              "sticker_name",
              "story",
              "story.anchor_gid",
              "story.comment_gid",
              "story.created_at",
              "story.created_by",
              "story.created_by.name",
              "story.resource_subtype",
              "story.text",
              "tag",
              "tag.name",
              "target",
              "target.created_by",
              "target.name",
              "target.resource_subtype",
              "task",
              "task.created_by",
              "task.name",
              "task.resource_subtype",
              "text",
              "type",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "anchor_gid",
                  "assignee",
                  "assignee.name",
                  "comment_gid",
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "custom_field",
                  "custom_field.date_value",
                  "custom_field.date_value.date",
                  "custom_field.date_value.date_time",
                  "custom_field.display_value",
                  "custom_field.enabled",
                  "custom_field.enum_options",
                  "custom_field.enum_options.color",
                  "custom_field.enum_options.enabled",
                  "custom_field.enum_options.name",
                  "custom_field.enum_value",
                  "custom_field.enum_value.color",
                  "custom_field.enum_value.enabled",
                  "custom_field.enum_value.name",
                  "custom_field.id_prefix",
                  "custom_field.input_restrictions",
                  "custom_field.is_formula_field",
                  "custom_field.is_lookup_field",
                  "custom_field.multi_enum_values",
                  "custom_field.multi_enum_values.color",
                  "custom_field.multi_enum_values.enabled",
                  "custom_field.multi_enum_values.name",
                  "custom_field.name",
                  "custom_field.number_value",
                  "custom_field.representation_type",
                  "custom_field.text_value",
                  "custom_field.type",
                  "dependency",
                  "dependency.created_by",
                  "dependency.name",
                  "dependency.resource_subtype",
                  "duplicate_of",
                  "duplicate_of.created_by",
                  "duplicate_of.name",
                  "duplicate_of.resource_subtype",
                  "duplicated_from",
                  "duplicated_from.created_by",
                  "duplicated_from.name",
                  "duplicated_from.resource_subtype",
                  "follower",
                  "follower.name",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_text",
                  "is_editable",
                  "is_edited",
                  "is_pinned",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "new_approval_status",
                  "new_date_value",
                  "new_dates",
                  "new_dates.due_at",
                  "new_dates.due_on",
                  "new_dates.start_on",
                  "new_enum_value",
                  "new_enum_value.color",
                  "new_enum_value.enabled",
                  "new_enum_value.name",
                  "new_multi_enum_values",
                  "new_multi_enum_values.color",
                  "new_multi_enum_values.enabled",
                  "new_multi_enum_values.name",
                  "new_name",
                  "new_number_value",
                  "new_people_value",
                  "new_people_value.name",
                  "new_resource_subtype",
                  "new_section",
                  "new_section.name",
                  "new_text_value",
                  "num_hearts",
                  "num_likes",
                  "offset",
                  "old_approval_status",
                  "old_date_value",
                  "old_dates",
                  "old_dates.due_at",
                  "old_dates.due_on",
                  "old_dates.start_on",
                  "old_enum_value",
                  "old_enum_value.color",
                  "old_enum_value.enabled",
                  "old_enum_value.name",
                  "old_multi_enum_values",
                  "old_multi_enum_values.color",
                  "old_multi_enum_values.enabled",
                  "old_multi_enum_values.name",
                  "old_name",
                  "old_number_value",
                  "old_people_value",
                  "old_people_value.name",
                  "old_resource_subtype",
                  "old_section",
                  "old_section.name",
                  "old_text_value",
                  "path",
                  "previews",
                  "previews.fallback",
                  "previews.footer",
                  "previews.header",
                  "previews.header_link",
                  "previews.html_text",
                  "previews.text",
                  "previews.title",
                  "previews.title_link",
                  "project",
                  "project.name",
                  "project.resource_subtype",
                  "reaction_summary",
                  "reaction_summary.count",
                  "reaction_summary.emoji_base",
                  "reaction_summary.reacted",
                  "reaction_summary.variant",
                  "resource_subtype",
                  "source",
                  "sticker_name",
                  "story",
                  "story.anchor_gid",
                  "story.comment_gid",
                  "story.created_at",
                  "story.created_by",
                  "story.created_by.name",
                  "story.resource_subtype",
                  "story.text",
                  "tag",
                  "tag.name",
                  "target",
                  "target.created_by",
                  "target.name",
                  "target.resource_subtype",
                  "task",
                  "task.created_by",
                  "task.name",
                  "task.resource_subtype",
                  "text",
                  "type",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/StoryCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__StoryResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the specified record's stories."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "stories:read"
            ]
          }
        ],
        "summary": "Get stories from a record",
        "tags": [
          "Stories"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1records~1{record_gid}~1stories/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet storiesApiInstance = new Asana.StoriesApi(client);\nlet record_gid = \"7331\"; // String | Globally unique identifier for the record.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'created_after': \"2012-02-22T02:06:58.158Z\", \n    'resource_subtype': \"comment_added\", \n    'sort_ascending': true, \n    'opt_fields': \"anchor_gid,assignee,assignee.name,comment_gid,created_at,created_by,created_by.name,custom_field,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_lookup_field,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.representation_type,custom_field.text_value,custom_field.type,dependency,dependency.created_by,dependency.name,dependency.resource_subtype,duplicate_of,duplicate_of.created_by,duplicate_of.name,duplicate_of.resource_subtype,duplicated_from,duplicated_from.created_by,duplicated_from.name,duplicated_from.resource_subtype,follower,follower.name,hearted,hearts,hearts.user,hearts.user.name,html_text,is_editable,is_edited,is_pinned,liked,likes,likes.user,likes.user.name,new_approval_status,new_date_value,new_dates,new_dates.due_at,new_dates.due_on,new_dates.start_on,new_enum_value,new_enum_value.color,new_enum_value.enabled,new_enum_value.name,new_multi_enum_values,new_multi_enum_values.color,new_multi_enum_values.enabled,new_multi_enum_values.name,new_name,new_number_value,new_people_value,new_people_value.name,new_resource_subtype,new_section,new_section.name,new_text_value,num_hearts,num_likes,offset,old_approval_status,old_date_value,old_dates,old_dates.due_at,old_dates.due_on,old_dates.start_on,old_enum_value,old_enum_value.color,old_enum_value.enabled,old_enum_value.name,old_multi_enum_values,old_multi_enum_values.color,old_multi_enum_values.enabled,old_multi_enum_values.name,old_name,old_number_value,old_people_value,old_people_value.name,old_resource_subtype,old_section,old_section.name,old_text_value,path,previews,previews.fallback,previews.footer,previews.header,previews.header_link,previews.html_text,previews.text,previews.title,previews.title_link,project,project.name,project.resource_subtype,reaction_summary,reaction_summary.count,reaction_summary.emoji_base,reaction_summary.reacted,reaction_summary.variant,resource_subtype,source,sticker_name,story,story.anchor_gid,story.comment_gid,story.created_at,story.created_by,story.created_by.name,story.resource_subtype,story.text,tag,tag.name,target,target.created_by,target.name,target.resource_subtype,task,task.created_by,task.name,task.resource_subtype,text,type,uri\"\n};\nstoriesApiInstance.getStoriesForRecord(record_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nstories_api_instance = asana.StoriesApi(api_client)\nrecord_gid = \"7331\" # str | Globally unique identifier for the record.\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    'created_after': '2012-02-22T02:06:58.158Z', # datetime | Only return stories created after this time. Applies to every story type; pair it with `resource_subtype=comment_added` to get just the comments added since a given moment. The bound is exclusive but has second granularity: it is truncated to the start of its second before filtering, so any story created within that same second is still returned. A client polling with the `created_at` of the last story it saw should expect to see that story again, and others alongside it, and should de-duplicate on `gid`. \n    'resource_subtype': \"comment_added\", # str | Only return stories of this subtype. Only `comment_added` is supported, which narrows the response to comments and excludes activity such as assignments, due date changes, and project moves. Omit to return the full activity feed. \n    'sort_ascending': False, # bool | Creation-time order: `true` (the default) is oldest first, `false` is newest first. Pair `false` with `limit` to read only the most recent stories. Ordering is applied across the parent's stories; on a parent with an extremely large activity feed the feed may be truncated before it is ordered, so pair `false` with `created_after` to bound what is considered. \n    'opt_fields': \"anchor_gid,assignee,assignee.name,comment_gid,created_at,created_by,created_by.name,custom_field,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_lookup_field,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.representation_type,custom_field.text_value,custom_field.type,dependency,dependency.created_by,dependency.name,dependency.resource_subtype,duplicate_of,duplicate_of.created_by,duplicate_of.name,duplicate_of.resource_subtype,duplicated_from,duplicated_from.created_by,duplicated_from.name,duplicated_from.resource_subtype,follower,follower.name,hearted,hearts,hearts.user,hearts.user.name,html_text,is_editable,is_edited,is_pinned,liked,likes,likes.user,likes.user.name,new_approval_status,new_date_value,new_dates,new_dates.due_at,new_dates.due_on,new_dates.start_on,new_enum_value,new_enum_value.color,new_enum_value.enabled,new_enum_value.name,new_multi_enum_values,new_multi_enum_values.color,new_multi_enum_values.enabled,new_multi_enum_values.name,new_name,new_number_value,new_people_value,new_people_value.name,new_resource_subtype,new_section,new_section.name,new_text_value,num_hearts,num_likes,offset,old_approval_status,old_date_value,old_dates,old_dates.due_at,old_dates.due_on,old_dates.start_on,old_enum_value,old_enum_value.color,old_enum_value.enabled,old_enum_value.name,old_multi_enum_values,old_multi_enum_values.color,old_multi_enum_values.enabled,old_multi_enum_values.name,old_name,old_number_value,old_people_value,old_people_value.name,old_resource_subtype,old_section,old_section.name,old_text_value,path,previews,previews.fallback,previews.footer,previews.header,previews.header_link,previews.html_text,previews.text,previews.title,previews.title_link,project,project.name,project.resource_subtype,reaction_summary,reaction_summary.count,reaction_summary.emoji_base,reaction_summary.reacted,reaction_summary.variant,resource_subtype,source,sticker_name,story,story.anchor_gid,story.comment_gid,story.created_at,story.created_by,story.created_by.name,story.resource_subtype,story.text,tag,tag.name,target,target.created_by,target.name,target.resource_subtype,task,task.created_by,task.name,task.resource_subtype,text,type,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get stories from a record\n    api_response = stories_api_instance.get_stories_for_record(record_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling StoriesApi->get_stories_for_record: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/record_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>stories:write</code>\n\nAdds a story to a record. This endpoint currently only allows for\ncomment stories to be created. The comment will be authored by the\ncurrently authenticated user, and timestamped when the server receives\nthe request.\n\nReturns the full record for the new story added to the record.",
        "operationId": "createStoryForRecord",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "anchor_gid",
              "assignee",
              "assignee.name",
              "comment_gid",
              "created_at",
              "created_by",
              "created_by.name",
              "custom_field",
              "custom_field.date_value",
              "custom_field.date_value.date",
              "custom_field.date_value.date_time",
              "custom_field.display_value",
              "custom_field.enabled",
              "custom_field.enum_options",
              "custom_field.enum_options.color",
              "custom_field.enum_options.enabled",
              "custom_field.enum_options.name",
              "custom_field.enum_value",
              "custom_field.enum_value.color",
              "custom_field.enum_value.enabled",
              "custom_field.enum_value.name",
              "custom_field.id_prefix",
              "custom_field.input_restrictions",
              "custom_field.is_formula_field",
              "custom_field.is_lookup_field",
              "custom_field.multi_enum_values",
              "custom_field.multi_enum_values.color",
              "custom_field.multi_enum_values.enabled",
              "custom_field.multi_enum_values.name",
              "custom_field.name",
              "custom_field.number_value",
              "custom_field.representation_type",
              "custom_field.text_value",
              "custom_field.type",
              "dependency",
              "dependency.created_by",
              "dependency.name",
              "dependency.resource_subtype",
              "duplicate_of",
              "duplicate_of.created_by",
              "duplicate_of.name",
              "duplicate_of.resource_subtype",
              "duplicated_from",
              "duplicated_from.created_by",
              "duplicated_from.name",
              "duplicated_from.resource_subtype",
              "follower",
              "follower.name",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_text",
              "is_editable",
              "is_edited",
              "is_pinned",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "new_approval_status",
              "new_date_value",
              "new_dates",
              "new_dates.due_at",
              "new_dates.due_on",
              "new_dates.start_on",
              "new_enum_value",
              "new_enum_value.color",
              "new_enum_value.enabled",
              "new_enum_value.name",
              "new_multi_enum_values",
              "new_multi_enum_values.color",
              "new_multi_enum_values.enabled",
              "new_multi_enum_values.name",
              "new_name",
              "new_number_value",
              "new_people_value",
              "new_people_value.name",
              "new_resource_subtype",
              "new_section",
              "new_section.name",
              "new_text_value",
              "num_hearts",
              "num_likes",
              "old_approval_status",
              "old_date_value",
              "old_dates",
              "old_dates.due_at",
              "old_dates.due_on",
              "old_dates.start_on",
              "old_enum_value",
              "old_enum_value.color",
              "old_enum_value.enabled",
              "old_enum_value.name",
              "old_multi_enum_values",
              "old_multi_enum_values.color",
              "old_multi_enum_values.enabled",
              "old_multi_enum_values.name",
              "old_name",
              "old_number_value",
              "old_people_value",
              "old_people_value.name",
              "old_resource_subtype",
              "old_section",
              "old_section.name",
              "old_text_value",
              "previews",
              "previews.fallback",
              "previews.footer",
              "previews.header",
              "previews.header_link",
              "previews.html_text",
              "previews.text",
              "previews.title",
              "previews.title_link",
              "project",
              "project.name",
              "project.resource_subtype",
              "reaction_summary",
              "reaction_summary.count",
              "reaction_summary.emoji_base",
              "reaction_summary.reacted",
              "reaction_summary.variant",
              "resource_subtype",
              "source",
              "sticker_name",
              "story",
              "story.anchor_gid",
              "story.comment_gid",
              "story.created_at",
              "story.created_by",
              "story.created_by.name",
              "story.resource_subtype",
              "story.text",
              "tag",
              "tag.name",
              "target",
              "target.created_by",
              "target.name",
              "target.resource_subtype",
              "task",
              "task.created_by",
              "task.name",
              "task.resource_subtype",
              "text",
              "type"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "anchor_gid",
                  "assignee",
                  "assignee.name",
                  "comment_gid",
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "custom_field",
                  "custom_field.date_value",
                  "custom_field.date_value.date",
                  "custom_field.date_value.date_time",
                  "custom_field.display_value",
                  "custom_field.enabled",
                  "custom_field.enum_options",
                  "custom_field.enum_options.color",
                  "custom_field.enum_options.enabled",
                  "custom_field.enum_options.name",
                  "custom_field.enum_value",
                  "custom_field.enum_value.color",
                  "custom_field.enum_value.enabled",
                  "custom_field.enum_value.name",
                  "custom_field.id_prefix",
                  "custom_field.input_restrictions",
                  "custom_field.is_formula_field",
                  "custom_field.is_lookup_field",
                  "custom_field.multi_enum_values",
                  "custom_field.multi_enum_values.color",
                  "custom_field.multi_enum_values.enabled",
                  "custom_field.multi_enum_values.name",
                  "custom_field.name",
                  "custom_field.number_value",
                  "custom_field.representation_type",
                  "custom_field.text_value",
                  "custom_field.type",
                  "dependency",
                  "dependency.created_by",
                  "dependency.name",
                  "dependency.resource_subtype",
                  "duplicate_of",
                  "duplicate_of.created_by",
                  "duplicate_of.name",
                  "duplicate_of.resource_subtype",
                  "duplicated_from",
                  "duplicated_from.created_by",
                  "duplicated_from.name",
                  "duplicated_from.resource_subtype",
                  "follower",
                  "follower.name",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_text",
                  "is_editable",
                  "is_edited",
                  "is_pinned",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "new_approval_status",
                  "new_date_value",
                  "new_dates",
                  "new_dates.due_at",
                  "new_dates.due_on",
                  "new_dates.start_on",
                  "new_enum_value",
                  "new_enum_value.color",
                  "new_enum_value.enabled",
                  "new_enum_value.name",
                  "new_multi_enum_values",
                  "new_multi_enum_values.color",
                  "new_multi_enum_values.enabled",
                  "new_multi_enum_values.name",
                  "new_name",
                  "new_number_value",
                  "new_people_value",
                  "new_people_value.name",
                  "new_resource_subtype",
                  "new_section",
                  "new_section.name",
                  "new_text_value",
                  "num_hearts",
                  "num_likes",
                  "old_approval_status",
                  "old_date_value",
                  "old_dates",
                  "old_dates.due_at",
                  "old_dates.due_on",
                  "old_dates.start_on",
                  "old_enum_value",
                  "old_enum_value.color",
                  "old_enum_value.enabled",
                  "old_enum_value.name",
                  "old_multi_enum_values",
                  "old_multi_enum_values.color",
                  "old_multi_enum_values.enabled",
                  "old_multi_enum_values.name",
                  "old_name",
                  "old_number_value",
                  "old_people_value",
                  "old_people_value.name",
                  "old_resource_subtype",
                  "old_section",
                  "old_section.name",
                  "old_text_value",
                  "previews",
                  "previews.fallback",
                  "previews.footer",
                  "previews.header",
                  "previews.header_link",
                  "previews.html_text",
                  "previews.text",
                  "previews.title",
                  "previews.title_link",
                  "project",
                  "project.name",
                  "project.resource_subtype",
                  "reaction_summary",
                  "reaction_summary.count",
                  "reaction_summary.emoji_base",
                  "reaction_summary.reacted",
                  "reaction_summary.variant",
                  "resource_subtype",
                  "source",
                  "sticker_name",
                  "story",
                  "story.anchor_gid",
                  "story.comment_gid",
                  "story.created_at",
                  "story.created_by",
                  "story.created_by.name",
                  "story.resource_subtype",
                  "story.text",
                  "tag",
                  "tag.name",
                  "target",
                  "target.created_by",
                  "target.name",
                  "target.resource_subtype",
                  "task",
                  "task.created_by",
                  "task.name",
                  "task.resource_subtype",
                  "text",
                  "type"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/StoryRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The story to create.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/StoryResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__StoryResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created a new story."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "stories:write"
            ]
          }
        ],
        "summary": "Create a story on a record",
        "tags": [
          "Stories"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1records~1{record_gid}~1stories/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet storiesApiInstance = new Asana.StoriesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The story to create.\nlet record_gid = \"7331\"; // String | Globally unique identifier for the record.\nlet opts = { \n    'opt_fields': \"anchor_gid,assignee,assignee.name,comment_gid,created_at,created_by,created_by.name,custom_field,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_lookup_field,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.representation_type,custom_field.text_value,custom_field.type,dependency,dependency.created_by,dependency.name,dependency.resource_subtype,duplicate_of,duplicate_of.created_by,duplicate_of.name,duplicate_of.resource_subtype,duplicated_from,duplicated_from.created_by,duplicated_from.name,duplicated_from.resource_subtype,follower,follower.name,hearted,hearts,hearts.user,hearts.user.name,html_text,is_editable,is_edited,is_pinned,liked,likes,likes.user,likes.user.name,new_approval_status,new_date_value,new_dates,new_dates.due_at,new_dates.due_on,new_dates.start_on,new_enum_value,new_enum_value.color,new_enum_value.enabled,new_enum_value.name,new_multi_enum_values,new_multi_enum_values.color,new_multi_enum_values.enabled,new_multi_enum_values.name,new_name,new_number_value,new_people_value,new_people_value.name,new_resource_subtype,new_section,new_section.name,new_text_value,num_hearts,num_likes,old_approval_status,old_date_value,old_dates,old_dates.due_at,old_dates.due_on,old_dates.start_on,old_enum_value,old_enum_value.color,old_enum_value.enabled,old_enum_value.name,old_multi_enum_values,old_multi_enum_values.color,old_multi_enum_values.enabled,old_multi_enum_values.name,old_name,old_number_value,old_people_value,old_people_value.name,old_resource_subtype,old_section,old_section.name,old_text_value,previews,previews.fallback,previews.footer,previews.header,previews.header_link,previews.html_text,previews.text,previews.title,previews.title_link,project,project.name,project.resource_subtype,reaction_summary,reaction_summary.count,reaction_summary.emoji_base,reaction_summary.reacted,reaction_summary.variant,resource_subtype,source,sticker_name,story,story.anchor_gid,story.comment_gid,story.created_at,story.created_by,story.created_by.name,story.resource_subtype,story.text,tag,tag.name,target,target.created_by,target.name,target.resource_subtype,task,task.created_by,task.name,task.resource_subtype,text,type\"\n};\nstoriesApiInstance.createStoryForRecord(body, record_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nstories_api_instance = asana.StoriesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The story to create.\nrecord_gid = \"7331\" # str | Globally unique identifier for the record.\nopts = {\n    'opt_fields': \"anchor_gid,assignee,assignee.name,comment_gid,created_at,created_by,created_by.name,custom_field,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_lookup_field,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.representation_type,custom_field.text_value,custom_field.type,dependency,dependency.created_by,dependency.name,dependency.resource_subtype,duplicate_of,duplicate_of.created_by,duplicate_of.name,duplicate_of.resource_subtype,duplicated_from,duplicated_from.created_by,duplicated_from.name,duplicated_from.resource_subtype,follower,follower.name,hearted,hearts,hearts.user,hearts.user.name,html_text,is_editable,is_edited,is_pinned,liked,likes,likes.user,likes.user.name,new_approval_status,new_date_value,new_dates,new_dates.due_at,new_dates.due_on,new_dates.start_on,new_enum_value,new_enum_value.color,new_enum_value.enabled,new_enum_value.name,new_multi_enum_values,new_multi_enum_values.color,new_multi_enum_values.enabled,new_multi_enum_values.name,new_name,new_number_value,new_people_value,new_people_value.name,new_resource_subtype,new_section,new_section.name,new_text_value,num_hearts,num_likes,old_approval_status,old_date_value,old_dates,old_dates.due_at,old_dates.due_on,old_dates.start_on,old_enum_value,old_enum_value.color,old_enum_value.enabled,old_enum_value.name,old_multi_enum_values,old_multi_enum_values.color,old_multi_enum_values.enabled,old_multi_enum_values.name,old_name,old_number_value,old_people_value,old_people_value.name,old_resource_subtype,old_section,old_section.name,old_text_value,previews,previews.fallback,previews.footer,previews.header,previews.header_link,previews.html_text,previews.text,previews.title,previews.title_link,project,project.name,project.resource_subtype,reaction_summary,reaction_summary.count,reaction_summary.emoji_base,reaction_summary.reacted,reaction_summary.variant,resource_subtype,source,sticker_name,story,story.anchor_gid,story.comment_gid,story.created_at,story.created_by,story.created_by.name,story.resource_subtype,story.text,tag,tag.name,target,target.created_by,target.name,target.resource_subtype,task,task.created_by,task.name,task.resource_subtype,text,type\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create a story on a record\n    api_response = stories_api_instance.create_story_for_record(body, record_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling StoriesApi->create_story_for_record: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/roles": {
      "get": {
        "description": "<b>Required scope: </b><code>roles:read</code>\n\nReturns all RBAC roles for a workspace.",
        "operationId": "getRoles",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "The workspace or organization to filter roles on.",
            "example": "1331",
            "in": "query",
            "name": "workspace",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/archived_query_param"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "base_role_type",
              "creation_time",
              "description",
              "is_standard_role",
              "modified_at",
              "name",
              "offset",
              "path",
              "permissions",
              "permissions.allowed_guest_invites",
              "permissions.assign_roles",
              "permissions.create_and_edit_ai_automations",
              "permissions.create_and_edit_ai_teammates",
              "permissions.create_app_authorization",
              "permissions.create_global_custom_fields",
              "permissions.create_goal",
              "permissions.create_pat_authorization",
              "permissions.create_portfolio",
              "permissions.create_project",
              "permissions.create_read_only_link",
              "permissions.create_team",
              "permissions.download_mobile_attachments",
              "permissions.export_project_data",
              "permissions.import_data",
              "permissions.manage_roles",
              "permissions.proactive_ai",
              "permissions.share_goal_with_domain",
              "permissions.share_portfolios_with_org",
              "permissions.share_teams_with_org",
              "permissions.standard_ai",
              "permissions.task_deletion_policy",
              "permissions.upload_attachments",
              "permissions.view_public_teams",
              "permissions.view_shared_with_org_portfolios",
              "permissions.view_shared_with_org_projects",
              "permissions.view_shared_with_org_tasks",
              "uri",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "base_role_type",
                  "creation_time",
                  "description",
                  "is_standard_role",
                  "modified_at",
                  "name",
                  "offset",
                  "path",
                  "permissions",
                  "permissions.allowed_guest_invites",
                  "permissions.assign_roles",
                  "permissions.create_and_edit_ai_automations",
                  "permissions.create_and_edit_ai_teammates",
                  "permissions.create_app_authorization",
                  "permissions.create_global_custom_fields",
                  "permissions.create_goal",
                  "permissions.create_pat_authorization",
                  "permissions.create_portfolio",
                  "permissions.create_project",
                  "permissions.create_read_only_link",
                  "permissions.create_team",
                  "permissions.download_mobile_attachments",
                  "permissions.export_project_data",
                  "permissions.import_data",
                  "permissions.manage_roles",
                  "permissions.proactive_ai",
                  "permissions.share_goal_with_domain",
                  "permissions.share_portfolios_with_org",
                  "permissions.share_teams_with_org",
                  "permissions.standard_ai",
                  "permissions.task_deletion_policy",
                  "permissions.upload_attachments",
                  "permissions.view_public_teams",
                  "permissions.view_shared_with_org_portfolios",
                  "permissions.view_shared_with_org_projects",
                  "permissions.view_shared_with_org_tasks",
                  "uri",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/RbacRoleCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__RbacRoleResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved roles."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "roles:read"
            ]
          }
        ],
        "summary": "Get multiple roles",
        "tags": [
          "Roles"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1roles/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet rolesApiInstance = new Asana.RolesApi(client);\nlet workspace = \"1331\"; // String | The workspace or organization to filter roles on.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'archived': false, \n    'opt_fields': \"base_role_type,creation_time,description,is_standard_role,modified_at,name,offset,path,permissions,permissions.allowed_guest_invites,permissions.assign_roles,permissions.create_and_edit_ai_automations,permissions.create_and_edit_ai_teammates,permissions.create_app_authorization,permissions.create_global_custom_fields,permissions.create_goal,permissions.create_pat_authorization,permissions.create_portfolio,permissions.create_project,permissions.create_read_only_link,permissions.create_team,permissions.download_mobile_attachments,permissions.export_project_data,permissions.import_data,permissions.manage_roles,permissions.proactive_ai,permissions.share_goal_with_domain,permissions.share_portfolios_with_org,permissions.share_teams_with_org,permissions.standard_ai,permissions.task_deletion_policy,permissions.upload_attachments,permissions.view_public_teams,permissions.view_shared_with_org_portfolios,permissions.view_shared_with_org_projects,permissions.view_shared_with_org_tasks,uri,workspace,workspace.name\"\n};\nrolesApiInstance.getRoles(workspace, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nroles_api_instance = asana.RolesApi(api_client)\nworkspace = \"1331\" # str | The workspace or organization to filter roles on.\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    'archived': False, # bool | Only return projects whose `archived` field takes on the value of this parameter.\n    'opt_fields': \"base_role_type,creation_time,description,is_standard_role,modified_at,name,offset,path,permissions,permissions.allowed_guest_invites,permissions.assign_roles,permissions.create_and_edit_ai_automations,permissions.create_and_edit_ai_teammates,permissions.create_app_authorization,permissions.create_global_custom_fields,permissions.create_goal,permissions.create_pat_authorization,permissions.create_portfolio,permissions.create_project,permissions.create_read_only_link,permissions.create_team,permissions.download_mobile_attachments,permissions.export_project_data,permissions.import_data,permissions.manage_roles,permissions.proactive_ai,permissions.share_goal_with_domain,permissions.share_portfolios_with_org,permissions.share_teams_with_org,permissions.standard_ai,permissions.task_deletion_policy,permissions.upload_attachments,permissions.view_public_teams,permissions.view_shared_with_org_portfolios,permissions.view_shared_with_org_projects,permissions.view_shared_with_org_tasks,uri,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get multiple roles\n    api_response = roles_api_instance.get_roles(workspace, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling RolesApi->get_roles: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>roles:write</code>\n\nCreates a new RBAC role in the workspace.",
        "operationId": "createRole",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "base_role_type",
              "creation_time",
              "description",
              "is_standard_role",
              "modified_at",
              "name",
              "permissions",
              "permissions.allowed_guest_invites",
              "permissions.assign_roles",
              "permissions.create_and_edit_ai_automations",
              "permissions.create_and_edit_ai_teammates",
              "permissions.create_app_authorization",
              "permissions.create_global_custom_fields",
              "permissions.create_goal",
              "permissions.create_pat_authorization",
              "permissions.create_portfolio",
              "permissions.create_project",
              "permissions.create_read_only_link",
              "permissions.create_team",
              "permissions.download_mobile_attachments",
              "permissions.export_project_data",
              "permissions.import_data",
              "permissions.manage_roles",
              "permissions.proactive_ai",
              "permissions.share_goal_with_domain",
              "permissions.share_portfolios_with_org",
              "permissions.share_teams_with_org",
              "permissions.standard_ai",
              "permissions.task_deletion_policy",
              "permissions.upload_attachments",
              "permissions.view_public_teams",
              "permissions.view_shared_with_org_portfolios",
              "permissions.view_shared_with_org_projects",
              "permissions.view_shared_with_org_tasks",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "base_role_type",
                  "creation_time",
                  "description",
                  "is_standard_role",
                  "modified_at",
                  "name",
                  "permissions",
                  "permissions.allowed_guest_invites",
                  "permissions.assign_roles",
                  "permissions.create_and_edit_ai_automations",
                  "permissions.create_and_edit_ai_teammates",
                  "permissions.create_app_authorization",
                  "permissions.create_global_custom_fields",
                  "permissions.create_goal",
                  "permissions.create_pat_authorization",
                  "permissions.create_portfolio",
                  "permissions.create_project",
                  "permissions.create_read_only_link",
                  "permissions.create_team",
                  "permissions.download_mobile_attachments",
                  "permissions.export_project_data",
                  "permissions.import_data",
                  "permissions.manage_roles",
                  "permissions.proactive_ai",
                  "permissions.share_goal_with_domain",
                  "permissions.share_portfolios_with_org",
                  "permissions.share_teams_with_org",
                  "permissions.standard_ai",
                  "permissions.task_deletion_policy",
                  "permissions.upload_attachments",
                  "permissions.view_public_teams",
                  "permissions.view_shared_with_org_portfolios",
                  "permissions.view_shared_with_org_projects",
                  "permissions.view_shared_with_org_tasks",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/RbacRoleRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The role to create.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/RbacRoleResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__RbacRoleResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created a new role."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "roles:write"
            ]
          }
        ],
        "summary": "Create a role",
        "tags": [
          "Roles"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1roles/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet rolesApiInstance = new Asana.RolesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The role to create.\nlet opts = { \n    'opt_fields': \"base_role_type,creation_time,description,is_standard_role,modified_at,name,permissions,permissions.allowed_guest_invites,permissions.assign_roles,permissions.create_and_edit_ai_automations,permissions.create_and_edit_ai_teammates,permissions.create_app_authorization,permissions.create_global_custom_fields,permissions.create_goal,permissions.create_pat_authorization,permissions.create_portfolio,permissions.create_project,permissions.create_read_only_link,permissions.create_team,permissions.download_mobile_attachments,permissions.export_project_data,permissions.import_data,permissions.manage_roles,permissions.proactive_ai,permissions.share_goal_with_domain,permissions.share_portfolios_with_org,permissions.share_teams_with_org,permissions.standard_ai,permissions.task_deletion_policy,permissions.upload_attachments,permissions.view_public_teams,permissions.view_shared_with_org_portfolios,permissions.view_shared_with_org_projects,permissions.view_shared_with_org_tasks,workspace,workspace.name\"\n};\nrolesApiInstance.createRole(body, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nroles_api_instance = asana.RolesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The role to create.\nopts = {\n    'opt_fields': \"base_role_type,creation_time,description,is_standard_role,modified_at,name,permissions,permissions.allowed_guest_invites,permissions.assign_roles,permissions.create_and_edit_ai_automations,permissions.create_and_edit_ai_teammates,permissions.create_app_authorization,permissions.create_global_custom_fields,permissions.create_goal,permissions.create_pat_authorization,permissions.create_portfolio,permissions.create_project,permissions.create_read_only_link,permissions.create_team,permissions.download_mobile_attachments,permissions.export_project_data,permissions.import_data,permissions.manage_roles,permissions.proactive_ai,permissions.share_goal_with_domain,permissions.share_portfolios_with_org,permissions.share_teams_with_org,permissions.standard_ai,permissions.task_deletion_policy,permissions.upload_attachments,permissions.view_public_teams,permissions.view_shared_with_org_portfolios,permissions.view_shared_with_org_projects,permissions.view_shared_with_org_tasks,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create a role\n    api_response = roles_api_instance.create_role(body, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling RolesApi->create_role: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/roles/{role_gid}": {
      "delete": {
        "description": "<b>Required scope: </b><code>roles:delete</code>\n\nDeletes a role from a workspace.",
        "operationId": "deleteRole",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully deleted the specified role."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "roles:delete"
            ]
          }
        ],
        "summary": "Delete a role",
        "tags": [
          "Roles"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1roles~1{role_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet rolesApiInstance = new Asana.RolesApi(client);\nlet role_gid = \"12345\"; // String | Globally unique identifier for the role.\n\nrolesApiInstance.deleteRole(role_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nroles_api_instance = asana.RolesApi(api_client)\nrole_gid = \"12345\" # str | Globally unique identifier for the role.\n\n\ntry:\n    # Delete a role\n    api_response = roles_api_instance.delete_role(role_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling RolesApi->delete_role: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "get": {
        "description": "<b>Required scope: </b><code>roles:read</code>\n\nReturns the complete role record for a single role.",
        "operationId": "getRole",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "base_role_type",
              "creation_time",
              "description",
              "is_standard_role",
              "modified_at",
              "name",
              "permissions",
              "permissions.allowed_guest_invites",
              "permissions.assign_roles",
              "permissions.create_and_edit_ai_automations",
              "permissions.create_and_edit_ai_teammates",
              "permissions.create_app_authorization",
              "permissions.create_global_custom_fields",
              "permissions.create_goal",
              "permissions.create_pat_authorization",
              "permissions.create_portfolio",
              "permissions.create_project",
              "permissions.create_read_only_link",
              "permissions.create_team",
              "permissions.download_mobile_attachments",
              "permissions.export_project_data",
              "permissions.import_data",
              "permissions.manage_roles",
              "permissions.proactive_ai",
              "permissions.share_goal_with_domain",
              "permissions.share_portfolios_with_org",
              "permissions.share_teams_with_org",
              "permissions.standard_ai",
              "permissions.task_deletion_policy",
              "permissions.upload_attachments",
              "permissions.view_public_teams",
              "permissions.view_shared_with_org_portfolios",
              "permissions.view_shared_with_org_projects",
              "permissions.view_shared_with_org_tasks",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "base_role_type",
                  "creation_time",
                  "description",
                  "is_standard_role",
                  "modified_at",
                  "name",
                  "permissions",
                  "permissions.allowed_guest_invites",
                  "permissions.assign_roles",
                  "permissions.create_and_edit_ai_automations",
                  "permissions.create_and_edit_ai_teammates",
                  "permissions.create_app_authorization",
                  "permissions.create_global_custom_fields",
                  "permissions.create_goal",
                  "permissions.create_pat_authorization",
                  "permissions.create_portfolio",
                  "permissions.create_project",
                  "permissions.create_read_only_link",
                  "permissions.create_team",
                  "permissions.download_mobile_attachments",
                  "permissions.export_project_data",
                  "permissions.import_data",
                  "permissions.manage_roles",
                  "permissions.proactive_ai",
                  "permissions.share_goal_with_domain",
                  "permissions.share_portfolios_with_org",
                  "permissions.share_teams_with_org",
                  "permissions.standard_ai",
                  "permissions.task_deletion_policy",
                  "permissions.upload_attachments",
                  "permissions.view_public_teams",
                  "permissions.view_shared_with_org_portfolios",
                  "permissions.view_shared_with_org_projects",
                  "permissions.view_shared_with_org_tasks",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/RbacRoleResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__RbacRoleResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested role."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "roles:read"
            ]
          }
        ],
        "summary": "Get a role",
        "tags": [
          "Roles"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1roles~1{role_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet rolesApiInstance = new Asana.RolesApi(client);\nlet role_gid = \"12345\"; // String | Globally unique identifier for the role.\nlet opts = { \n    'opt_fields': \"base_role_type,creation_time,description,is_standard_role,modified_at,name,permissions,permissions.allowed_guest_invites,permissions.assign_roles,permissions.create_and_edit_ai_automations,permissions.create_and_edit_ai_teammates,permissions.create_app_authorization,permissions.create_global_custom_fields,permissions.create_goal,permissions.create_pat_authorization,permissions.create_portfolio,permissions.create_project,permissions.create_read_only_link,permissions.create_team,permissions.download_mobile_attachments,permissions.export_project_data,permissions.import_data,permissions.manage_roles,permissions.proactive_ai,permissions.share_goal_with_domain,permissions.share_portfolios_with_org,permissions.share_teams_with_org,permissions.standard_ai,permissions.task_deletion_policy,permissions.upload_attachments,permissions.view_public_teams,permissions.view_shared_with_org_portfolios,permissions.view_shared_with_org_projects,permissions.view_shared_with_org_tasks,workspace,workspace.name\"\n};\nrolesApiInstance.getRole(role_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nroles_api_instance = asana.RolesApi(api_client)\nrole_gid = \"12345\" # str | Globally unique identifier for the role.\nopts = {\n    'opt_fields': \"base_role_type,creation_time,description,is_standard_role,modified_at,name,permissions,permissions.allowed_guest_invites,permissions.assign_roles,permissions.create_and_edit_ai_automations,permissions.create_and_edit_ai_teammates,permissions.create_app_authorization,permissions.create_global_custom_fields,permissions.create_goal,permissions.create_pat_authorization,permissions.create_portfolio,permissions.create_project,permissions.create_read_only_link,permissions.create_team,permissions.download_mobile_attachments,permissions.export_project_data,permissions.import_data,permissions.manage_roles,permissions.proactive_ai,permissions.share_goal_with_domain,permissions.share_portfolios_with_org,permissions.share_teams_with_org,permissions.standard_ai,permissions.task_deletion_policy,permissions.upload_attachments,permissions.view_public_teams,permissions.view_shared_with_org_portfolios,permissions.view_shared_with_org_projects,permissions.view_shared_with_org_tasks,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a role\n    api_response = roles_api_instance.get_role(role_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling RolesApi->get_role: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/role_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/rule_triggers/{rule_trigger_gid}/run": {
      "parameters": [
        {
          "$ref": "#/components/parameters/rule_trigger_path_gid"
        }
      ],
      "post": {
        "description": "Trigger a rule which uses an [\"incoming web request\"](/docs/incoming-web-requests) trigger.",
        "operationId": "triggerRule",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/RuleTriggerRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "A dictionary of variables accessible from within the rule.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/RuleTriggerResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__RuleTriggerResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully triggered a rule."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Trigger a rule",
        "tags": [
          "Rules"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1rule_triggers~1{rule_trigger_gid}~1run/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet rulesApiInstance = new Asana.RulesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | A dictionary of variables accessible from within the rule.\nlet rule_trigger_gid = \"12345\"; // String | The ID of the incoming web request trigger. This value is a path parameter that is automatically generated for the API endpoint.\n\nrulesApiInstance.triggerRule(body, rule_trigger_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.rules.triggerRule(ruleTriggerGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nrules_api_instance = asana.RulesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | A dictionary of variables accessible from within the rule.\nrule_trigger_gid = \"12345\" # str | The ID of the incoming web request trigger. This value is a path parameter that is automatically generated for the API endpoint.\n\n\ntry:\n    # Trigger a rule\n    api_response = rules_api_instance.trigger_rule(body, rule_trigger_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling RulesApi->trigger_rule: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.rules.trigger_rule(rule_trigger_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            }
          ]
        }
      }
    },
    "/sections/{section_gid}": {
      "delete": {
        "description": "<b>Required scope: </b><code>projects:write</code>\n\nA specific, existing section can be deleted by making a DELETE request on\nthe URL for that section.\n\nNote that sections must be empty to be deleted.\n\nThe last remaining section cannot be deleted.\n\nReturns an empty data block.",
        "operationId": "deleteSection",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully deleted the specified section."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "projects:write"
            ]
          }
        ],
        "summary": "Delete a section",
        "tags": [
          "Sections"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1sections~1{section_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.sections.deleteSection(sectionGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet sectionsApiInstance = new Asana.SectionsApi(client);\nlet section_gid = \"321654\"; // String | The globally unique identifier for the section.\n\nsectionsApiInstance.deleteSection(section_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.sections.deleteSection(sectionGid)\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nsections_api_instance = asana.SectionsApi(api_client)\nsection_gid = \"321654\" # str | The globally unique identifier for the section.\n\n\ntry:\n    # Delete a section\n    api_response = sections_api_instance.delete_section(section_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling SectionsApi->delete_section: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.sections.delete_section(section_gid, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->sections->deleteSection($section_gid, array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.sections.delete_section(section_gid: 'section_gid', options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "get": {
        "description": "<b>Required scope: </b><code>projects:read</code>\n\nReturns the complete record for a single section.",
        "operationId": "getSection",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_at",
              "name",
              "project",
              "project.name",
              "project.resource_subtype",
              "projects",
              "projects.name",
              "projects.resource_subtype"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_at",
                  "name",
                  "project",
                  "project.name",
                  "project.resource_subtype",
                  "projects",
                  "projects.name",
                  "projects.resource_subtype"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/SectionResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__SectionResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved section."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "projects:read"
            ]
          }
        ],
        "summary": "Get a section",
        "tags": [
          "Sections"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1sections~1{section_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nSection result = client.sections.getSection(sectionGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet sectionsApiInstance = new Asana.SectionsApi(client);\nlet section_gid = \"321654\"; // String | The globally unique identifier for the section.\nlet opts = { \n    'opt_fields': \"created_at,name,project,project.name,project.resource_subtype,projects,projects.name,projects.resource_subtype\"\n};\nsectionsApiInstance.getSection(section_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.sections.getSection(sectionGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nsections_api_instance = asana.SectionsApi(api_client)\nsection_gid = \"321654\" # str | The globally unique identifier for the section.\nopts = {\n    'opt_fields': \"created_at,name,project,project.name,project.resource_subtype,projects,projects.name,projects.resource_subtype\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a section\n    api_response = sections_api_instance.get_section(section_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling SectionsApi->get_section: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.sections.get_section(section_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->sections->getSection($section_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.sections.get_section(section_gid: 'section_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/section_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "put": {
        "description": "<b>Required scope: </b><code>projects:write</code>\n\nA specific, existing section can be updated by making a PUT request on\nthe URL for that project. Only the fields provided in the `data` block\nwill be updated; any unspecified fields will remain unchanged. (note that\nat this time, the only field that can be updated is the `name` field.)\n\nWhen using this method, it is best to specify only those fields you wish\nto change, or else you may overwrite changes made by another user since\nyou last retrieved the task.\n\nReturns the complete updated section record.",
        "operationId": "updateSection",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_at",
              "name",
              "project",
              "project.name",
              "project.resource_subtype",
              "projects",
              "projects.name",
              "projects.resource_subtype"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_at",
                  "name",
                  "project",
                  "project.name",
                  "project.resource_subtype",
                  "projects",
                  "projects.name",
                  "projects.resource_subtype"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/SectionRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The section to create."
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/SectionResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__SectionResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully updated the specified section."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "projects:write"
            ]
          }
        ],
        "summary": "Update a section",
        "tags": [
          "Sections"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1sections~1{section_gid}/put",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nSection result = client.sections.updateSection(sectionGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet sectionsApiInstance = new Asana.SectionsApi(client);\nlet section_gid = \"321654\"; // String | The globally unique identifier for the section.\nlet opts = { \n    'body': {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}, \n    'opt_fields': \"created_at,name,project,project.name,project.resource_subtype,projects,projects.name,projects.resource_subtype\"\n};\nsectionsApiInstance.updateSection(section_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.sections.updateSection(sectionGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nsections_api_instance = asana.SectionsApi(api_client)\nsection_gid = \"321654\" # str | The globally unique identifier for the section.\nopts = {\n    'body': {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}, # dict | The section to create.\n    'opt_fields': \"created_at,name,project,project.name,project.resource_subtype,projects,projects.name,projects.resource_subtype\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Update a section\n    api_response = sections_api_instance.update_section(section_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling SectionsApi->update_section: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.sections.update_section(section_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->sections->updateSection($section_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.sections.update_section(section_gid: 'section_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/sections/{section_gid}/addTask": {
      "parameters": [
        {
          "$ref": "#/components/parameters/section_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>tasks:write</code>\n\nAdd a task to a specific, existing section. This will remove the task from other sections of the project.\n\nThe task will be inserted at the top of a section unless an insert_before or insert_after parameter is declared.\n\nThis does not work for separators (tasks with the resource_subtype of section).",
        "operationId": "addTaskForSection",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/SectionTaskInsertRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The task and optionally the insert location."
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully added the task."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:write"
            ]
          }
        ],
        "summary": "Add task to section",
        "tags": [
          "Sections"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1sections~1{section_gid}~1addTask/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.sections.addTaskForSection(sectionGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet sectionsApiInstance = new Asana.SectionsApi(client);\nlet section_gid = \"321654\"; // String | The globally unique identifier for the section.\nlet opts = { \n    'body': {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}\n};\nsectionsApiInstance.addTaskForSection(section_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.sections.addTaskForSection(sectionGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nsections_api_instance = asana.SectionsApi(api_client)\nsection_gid = \"321654\" # str | The globally unique identifier for the section.\nopts = {\n    'body': {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}, # dict | The task and optionally the insert location.\n}\n\ntry:\n    # Add task to section\n    api_response = sections_api_instance.add_task_for_section(section_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling SectionsApi->add_task_for_section: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.sections.add_task_for_section(section_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->sections->addTaskForSection($section_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.sections.add_task_for_section(section_gid: 'section_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/sections/{section_gid}/tasks": {
      "get": {
        "description": "<b>Required scope: </b><code>tasks:read</code>\n\n*Board view only*: Returns the compact section records for all tasks within the given section.",
        "operationId": "getTasksForSection",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "actual_time_minutes",
              "approval_status",
              "assigned_by",
              "assigned_by.name",
              "assignee",
              "assignee.name",
              "assignee_section",
              "assignee_section.name",
              "assignee_status",
              "completed",
              "completed_at",
              "completed_by",
              "completed_by.name",
              "created_at",
              "created_by",
              "custom_fields",
              "custom_fields.asana_created_field",
              "custom_fields.created_by",
              "custom_fields.created_by.name",
              "custom_fields.currency_code",
              "custom_fields.custom_label",
              "custom_fields.custom_label_position",
              "custom_fields.date_value",
              "custom_fields.date_value.date",
              "custom_fields.date_value.date_time",
              "custom_fields.default_access_level",
              "custom_fields.description",
              "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.format",
              "custom_fields.has_notifications_enabled",
              "custom_fields.html_text_value",
              "custom_fields.id_prefix",
              "custom_fields.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_global_to_workspace",
              "custom_fields.is_lookup_field",
              "custom_fields.is_value_read_only",
              "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.people_value",
              "custom_fields.people_value.name",
              "custom_fields.precision",
              "custom_fields.privacy_setting",
              "custom_fields.reference_value",
              "custom_fields.reference_value.name",
              "custom_fields.representation_type",
              "custom_fields.resource_subtype",
              "custom_fields.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "custom_type_status_option",
              "custom_type_status_option.name",
              "dependencies",
              "dependents",
              "due_at",
              "due_on",
              "effective_memberships",
              "external",
              "external.data",
              "followers",
              "followers.name",
              "has_subtasks_date_mismatch",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_notes",
              "is_rendered_as_separator",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "memberships",
              "memberships.project",
              "memberships.project.name",
              "memberships.project.resource_subtype",
              "memberships.section",
              "memberships.section.name",
              "modified_at",
              "name",
              "notes",
              "num_hearts",
              "num_likes",
              "num_subtasks",
              "offset",
              "parent",
              "parent.created_by",
              "parent.name",
              "parent.resource_subtype",
              "path",
              "permalink_url",
              "projects",
              "projects.name",
              "projects.resource_subtype",
              "resource_subtype",
              "start_at",
              "start_on",
              "tags",
              "tags.name",
              "uri",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "actual_time_minutes",
                  "approval_status",
                  "assigned_by",
                  "assigned_by.name",
                  "assignee",
                  "assignee.name",
                  "assignee_section",
                  "assignee_section.name",
                  "assignee_status",
                  "completed",
                  "completed_at",
                  "completed_by",
                  "completed_by.name",
                  "created_at",
                  "created_by",
                  "custom_fields",
                  "custom_fields.asana_created_field",
                  "custom_fields.created_by",
                  "custom_fields.created_by.name",
                  "custom_fields.currency_code",
                  "custom_fields.custom_label",
                  "custom_fields.custom_label_position",
                  "custom_fields.date_value",
                  "custom_fields.date_value.date",
                  "custom_fields.date_value.date_time",
                  "custom_fields.default_access_level",
                  "custom_fields.description",
                  "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.format",
                  "custom_fields.has_notifications_enabled",
                  "custom_fields.html_text_value",
                  "custom_fields.id_prefix",
                  "custom_fields.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_global_to_workspace",
                  "custom_fields.is_lookup_field",
                  "custom_fields.is_value_read_only",
                  "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.people_value",
                  "custom_fields.people_value.name",
                  "custom_fields.precision",
                  "custom_fields.privacy_setting",
                  "custom_fields.reference_value",
                  "custom_fields.reference_value.name",
                  "custom_fields.representation_type",
                  "custom_fields.resource_subtype",
                  "custom_fields.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "custom_type_status_option",
                  "custom_type_status_option.name",
                  "dependencies",
                  "dependents",
                  "due_at",
                  "due_on",
                  "effective_memberships",
                  "external",
                  "external.data",
                  "followers",
                  "followers.name",
                  "has_subtasks_date_mismatch",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_notes",
                  "is_rendered_as_separator",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "memberships",
                  "memberships.project",
                  "memberships.project.name",
                  "memberships.project.resource_subtype",
                  "memberships.section",
                  "memberships.section.name",
                  "modified_at",
                  "name",
                  "notes",
                  "num_hearts",
                  "num_likes",
                  "num_subtasks",
                  "offset",
                  "parent",
                  "parent.created_by",
                  "parent.name",
                  "parent.resource_subtype",
                  "path",
                  "permalink_url",
                  "projects",
                  "projects.name",
                  "projects.resource_subtype",
                  "resource_subtype",
                  "start_at",
                  "start_on",
                  "tags",
                  "tags.name",
                  "uri",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TaskCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TaskResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the section's tasks."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:read"
            ]
          }
        ],
        "summary": "Get tasks from a section",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1sections~1{section_gid}~1tasks/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Task> result = client.tasks.getTasksForSection(sectionGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet section_gid = \"321654\"; // String | The globally unique identifier for the section.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'completed_since': \"2012-02-22T02:06:58.158Z\", \n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,offset,parent,parent.created_by,parent.name,parent.resource_subtype,path,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,uri,workspace,workspace.name\"\n};\ntasksApiInstance.getTasksForSection(section_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.getTasksForSection(sectionGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\nsection_gid = \"321654\" # str | The globally unique identifier for the section.\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    'completed_since': \"2012-02-22T02:06:58.158Z\", # str | Only return tasks that are either incomplete or that have been completed since this time. Accepts a date-time string or the keyword *now*. \n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,offset,parent,parent.created_by,parent.name,parent.resource_subtype,path,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,uri,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get tasks from a section\n    api_response = tasks_api_instance.get_tasks_for_section(section_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->get_tasks_for_section: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.get_tasks_for_section(section_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->getTasksForSection($section_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.get_tasks_for_section(section_gid: 'section_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/section_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        },
        {
          "$ref": "#/components/parameters/completed_since"
        }
      ]
    },
    "/status_updates": {
      "get": {
        "description": "Returns the compact status update records for all updates on the object.",
        "operationId": "getStatusesForObject",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "Globally unique identifier for object to fetch statuses from. Must be a GID for a project, portfolio, or goal.",
            "example": "159874",
            "in": "query",
            "name": "parent",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Only return statuses that have been created since the given time.",
            "example": "2012-02-22T02:06:58.158Z",
            "in": "query",
            "name": "created_since",
            "schema": {
              "format": "date-time",
              "type": "string"
            }
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "author",
              "author.name",
              "created_at",
              "created_by",
              "created_by.name",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_text",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "modified_at",
              "num_hearts",
              "num_likes",
              "offset",
              "parent",
              "parent.name",
              "parent.resource_subtype",
              "path",
              "reaction_summary",
              "reaction_summary.count",
              "reaction_summary.emoji_base",
              "reaction_summary.reacted",
              "reaction_summary.variant",
              "resource_subtype",
              "status_type",
              "text",
              "title",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "author",
                  "author.name",
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_text",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "modified_at",
                  "num_hearts",
                  "num_likes",
                  "offset",
                  "parent",
                  "parent.name",
                  "parent.resource_subtype",
                  "path",
                  "reaction_summary",
                  "reaction_summary.count",
                  "reaction_summary.emoji_base",
                  "reaction_summary.reacted",
                  "reaction_summary.variant",
                  "resource_subtype",
                  "status_type",
                  "text",
                  "title",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/StatusUpdateCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__StatusUpdateResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the specified object's status updates."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get status updates from an object",
        "tags": [
          "Status updates"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1status_updates/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<JsonElement> result = client.statusupdates.getStatusesForObject(createdSince, parent)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet statusUpdatesApiInstance = new Asana.StatusUpdatesApi(client);\nlet parent = \"159874\"; // String | Globally unique identifier for object to fetch statuses from. Must be a GID for a project, portfolio, or goal.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'created_since': \"2012-02-22T02:06:58.158Z\", \n    'opt_fields': \"author,author.name,created_at,created_by,created_by.name,hearted,hearts,hearts.user,hearts.user.name,html_text,liked,likes,likes.user,likes.user.name,modified_at,num_hearts,num_likes,offset,parent,parent.name,parent.resource_subtype,path,reaction_summary,reaction_summary.count,reaction_summary.emoji_base,reaction_summary.reacted,reaction_summary.variant,resource_subtype,status_type,text,title,uri\"\n};\nstatusUpdatesApiInstance.getStatusesForObject(parent, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.statusupdates.getStatusesForObject({param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nstatus_updates_api_instance = asana.StatusUpdatesApi(api_client)\nparent = \"159874\" # str | Globally unique identifier for object to fetch statuses from. Must be a GID for a project, portfolio, or goal.\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    'created_since': '2012-02-22T02:06:58.158Z', # datetime | Only return statuses that have been created since the given time.\n    'opt_fields': \"author,author.name,created_at,created_by,created_by.name,hearted,hearts,hearts.user,hearts.user.name,html_text,liked,likes,likes.user,likes.user.name,modified_at,num_hearts,num_likes,offset,parent,parent.name,parent.resource_subtype,path,reaction_summary,reaction_summary.count,reaction_summary.emoji_base,reaction_summary.reacted,reaction_summary.variant,resource_subtype,status_type,text,title,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get status updates from an object\n    api_response = status_updates_api_instance.get_statuses_for_object(parent, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling StatusUpdatesApi->get_statuses_for_object: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.status_updates.get_statuses_for_object({'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->statusupdates->getStatusesForObject(array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.status_updates.get_statuses_for_object(parent: '&#x27;parent_example&#x27;', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "Creates a new status update on an object.\nReturns the full record of the newly created status update.",
        "operationId": "createStatusForObject",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "author",
              "author.name",
              "created_at",
              "created_by",
              "created_by.name",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_text",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "modified_at",
              "num_hearts",
              "num_likes",
              "parent",
              "parent.name",
              "parent.resource_subtype",
              "reaction_summary",
              "reaction_summary.count",
              "reaction_summary.emoji_base",
              "reaction_summary.reacted",
              "reaction_summary.variant",
              "resource_subtype",
              "status_type",
              "text",
              "title"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "author",
                  "author.name",
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_text",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "modified_at",
                  "num_hearts",
                  "num_likes",
                  "parent",
                  "parent.name",
                  "parent.resource_subtype",
                  "reaction_summary",
                  "reaction_summary.count",
                  "reaction_summary.emoji_base",
                  "reaction_summary.reacted",
                  "reaction_summary.variant",
                  "resource_subtype",
                  "status_type",
                  "text",
                  "title"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/StatusUpdateRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The status update to create.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/StatusUpdateResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__StatusUpdateResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created a new status update."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Create a status update",
        "tags": [
          "Status updates"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1status_updates/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.statusupdates.createStatusForObject()\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet statusUpdatesApiInstance = new Asana.StatusUpdatesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The status update to create.\nlet opts = { \n    'opt_fields': \"author,author.name,created_at,created_by,created_by.name,hearted,hearts,hearts.user,hearts.user.name,html_text,liked,likes,likes.user,likes.user.name,modified_at,num_hearts,num_likes,parent,parent.name,parent.resource_subtype,reaction_summary,reaction_summary.count,reaction_summary.emoji_base,reaction_summary.reacted,reaction_summary.variant,resource_subtype,status_type,text,title\"\n};\nstatusUpdatesApiInstance.createStatusForObject(body, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.statusupdates.createStatusForObject({field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nstatus_updates_api_instance = asana.StatusUpdatesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The status update to create.\nopts = {\n    'opt_fields': \"author,author.name,created_at,created_by,created_by.name,hearted,hearts,hearts.user,hearts.user.name,html_text,liked,likes,likes.user,likes.user.name,modified_at,num_hearts,num_likes,parent,parent.name,parent.resource_subtype,reaction_summary,reaction_summary.count,reaction_summary.emoji_base,reaction_summary.reacted,reaction_summary.variant,resource_subtype,status_type,text,title\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create a status update\n    api_response = status_updates_api_instance.create_status_for_object(body, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling StatusUpdatesApi->create_status_for_object: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.status_updates.create_status_for_object({'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->statusupdates->createStatusForObject(array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.status_updates.create_status_for_object(field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/status_updates/{status_update_gid}": {
      "delete": {
        "description": "Deletes a specific, existing status update.\n\nReturns an empty data record.",
        "operationId": "deleteStatus",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully deleted the specified status."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Delete a status update",
        "tags": [
          "Status updates"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1status_updates~1{status_update_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.statusupdates.deleteStatus(statusGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet statusUpdatesApiInstance = new Asana.StatusUpdatesApi(client);\nlet status_update_gid = \"321654\"; // String | Globally unique identifier for the status update.\n\nstatusUpdatesApiInstance.deleteStatus(status_update_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.statusupdates.deleteStatus(statusUpdateGid)\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nstatus_updates_api_instance = asana.StatusUpdatesApi(api_client)\nstatus_update_gid = \"321654\" # str | Globally unique identifier for the status update.\n\n\ntry:\n    # Delete a status update\n    api_response = status_updates_api_instance.delete_status(status_update_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling StatusUpdatesApi->delete_status: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.status_updates.delete_status(status_update_gid, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->statusupdates->deleteStatus($status_gid, array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.status_updates.delete_status(status_gid: 'status_gid', options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "get": {
        "description": "Returns the complete record for a single status update.",
        "operationId": "getStatus",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "author",
              "author.name",
              "created_at",
              "created_by",
              "created_by.name",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_text",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "modified_at",
              "num_hearts",
              "num_likes",
              "parent",
              "parent.name",
              "parent.resource_subtype",
              "reaction_summary",
              "reaction_summary.count",
              "reaction_summary.emoji_base",
              "reaction_summary.reacted",
              "reaction_summary.variant",
              "resource_subtype",
              "status_type",
              "text",
              "title"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "author",
                  "author.name",
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_text",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "modified_at",
                  "num_hearts",
                  "num_likes",
                  "parent",
                  "parent.name",
                  "parent.resource_subtype",
                  "reaction_summary",
                  "reaction_summary.count",
                  "reaction_summary.emoji_base",
                  "reaction_summary.reacted",
                  "reaction_summary.variant",
                  "resource_subtype",
                  "status_type",
                  "text",
                  "title"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/StatusUpdateResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__StatusUpdateResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the specified object's status updates."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get a status update",
        "tags": [
          "Status updates"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1status_updates~1{status_update_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.statusupdates.getStatus(statusGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet statusUpdatesApiInstance = new Asana.StatusUpdatesApi(client);\nlet status_update_gid = \"321654\"; // String | Globally unique identifier for the status update.\nlet opts = { \n    'opt_fields': \"author,author.name,created_at,created_by,created_by.name,hearted,hearts,hearts.user,hearts.user.name,html_text,liked,likes,likes.user,likes.user.name,modified_at,num_hearts,num_likes,parent,parent.name,parent.resource_subtype,reaction_summary,reaction_summary.count,reaction_summary.emoji_base,reaction_summary.reacted,reaction_summary.variant,resource_subtype,status_type,text,title\"\n};\nstatusUpdatesApiInstance.getStatus(status_update_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.statusupdates.getStatus(statusUpdateGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nstatus_updates_api_instance = asana.StatusUpdatesApi(api_client)\nstatus_update_gid = \"321654\" # str | Globally unique identifier for the status update.\nopts = {\n    'opt_fields': \"author,author.name,created_at,created_by,created_by.name,hearted,hearts,hearts.user,hearts.user.name,html_text,liked,likes,likes.user,likes.user.name,modified_at,num_hearts,num_likes,parent,parent.name,parent.resource_subtype,reaction_summary,reaction_summary.count,reaction_summary.emoji_base,reaction_summary.reacted,reaction_summary.variant,resource_subtype,status_type,text,title\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a status update\n    api_response = status_updates_api_instance.get_status(status_update_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling StatusUpdatesApi->get_status: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.status_updates.get_status(status_update_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->statusupdates->getStatus($status_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.status_updates.get_status(status_gid: 'status_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/status_update_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/stories/{story_gid}": {
      "delete": {
        "description": "<b>Required scope: </b><code>stories:delete</code>\n\nDeletes a story. A user can only delete stories they have created.\n\nReturns an empty data record.",
        "operationId": "deleteStory",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully deleted the specified story."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "stories:delete"
            ]
          }
        ],
        "summary": "Delete a story",
        "tags": [
          "Stories"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1stories~1{story_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.stories.deleteStory(storyGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet storiesApiInstance = new Asana.StoriesApi(client);\nlet story_gid = \"35678\"; // String | Globally unique identifier for the story.\n\nstoriesApiInstance.deleteStory(story_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.stories.deleteStory(storyGid)\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nstories_api_instance = asana.StoriesApi(api_client)\nstory_gid = \"35678\" # str | Globally unique identifier for the story.\n\n\ntry:\n    # Delete a story\n    api_response = stories_api_instance.delete_story(story_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling StoriesApi->delete_story: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.stories.delete_story(story_gid, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->stories->deleteStory($story_gid, array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.stories.delete_story(story_gid: 'story_gid', options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "get": {
        "description": "<b>Required scope: </b><code>stories:read</code>\n\n<table>\n  <tr>\n    <th>Field</th>\n    <th>Required Scope</th>\n  </tr>\n  <tr>\n    <td><code>previews</code></td>\n    <td><code>attachments:read</code></td>\n  </tr>\n  <tr>\n    <td><code>attachments</code></td>\n    <td><code>attachments:read</code></td>\n  </tr>\n</table>\n\nReturns the full record for a single story.",
        "operationId": "getStory",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "anchor_gid",
              "assignee",
              "assignee.name",
              "comment_gid",
              "created_at",
              "created_by",
              "created_by.name",
              "custom_field",
              "custom_field.date_value",
              "custom_field.date_value.date",
              "custom_field.date_value.date_time",
              "custom_field.display_value",
              "custom_field.enabled",
              "custom_field.enum_options",
              "custom_field.enum_options.color",
              "custom_field.enum_options.enabled",
              "custom_field.enum_options.name",
              "custom_field.enum_value",
              "custom_field.enum_value.color",
              "custom_field.enum_value.enabled",
              "custom_field.enum_value.name",
              "custom_field.id_prefix",
              "custom_field.input_restrictions",
              "custom_field.is_formula_field",
              "custom_field.is_lookup_field",
              "custom_field.multi_enum_values",
              "custom_field.multi_enum_values.color",
              "custom_field.multi_enum_values.enabled",
              "custom_field.multi_enum_values.name",
              "custom_field.name",
              "custom_field.number_value",
              "custom_field.representation_type",
              "custom_field.text_value",
              "custom_field.type",
              "dependency",
              "dependency.created_by",
              "dependency.name",
              "dependency.resource_subtype",
              "duplicate_of",
              "duplicate_of.created_by",
              "duplicate_of.name",
              "duplicate_of.resource_subtype",
              "duplicated_from",
              "duplicated_from.created_by",
              "duplicated_from.name",
              "duplicated_from.resource_subtype",
              "follower",
              "follower.name",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_text",
              "is_editable",
              "is_edited",
              "is_pinned",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "new_approval_status",
              "new_date_value",
              "new_dates",
              "new_dates.due_at",
              "new_dates.due_on",
              "new_dates.start_on",
              "new_enum_value",
              "new_enum_value.color",
              "new_enum_value.enabled",
              "new_enum_value.name",
              "new_multi_enum_values",
              "new_multi_enum_values.color",
              "new_multi_enum_values.enabled",
              "new_multi_enum_values.name",
              "new_name",
              "new_number_value",
              "new_people_value",
              "new_people_value.name",
              "new_resource_subtype",
              "new_section",
              "new_section.name",
              "new_text_value",
              "num_hearts",
              "num_likes",
              "old_approval_status",
              "old_date_value",
              "old_dates",
              "old_dates.due_at",
              "old_dates.due_on",
              "old_dates.start_on",
              "old_enum_value",
              "old_enum_value.color",
              "old_enum_value.enabled",
              "old_enum_value.name",
              "old_multi_enum_values",
              "old_multi_enum_values.color",
              "old_multi_enum_values.enabled",
              "old_multi_enum_values.name",
              "old_name",
              "old_number_value",
              "old_people_value",
              "old_people_value.name",
              "old_resource_subtype",
              "old_section",
              "old_section.name",
              "old_text_value",
              "previews",
              "previews.fallback",
              "previews.footer",
              "previews.header",
              "previews.header_link",
              "previews.html_text",
              "previews.text",
              "previews.title",
              "previews.title_link",
              "project",
              "project.name",
              "project.resource_subtype",
              "reaction_summary",
              "reaction_summary.count",
              "reaction_summary.emoji_base",
              "reaction_summary.reacted",
              "reaction_summary.variant",
              "resource_subtype",
              "source",
              "sticker_name",
              "story",
              "story.anchor_gid",
              "story.comment_gid",
              "story.created_at",
              "story.created_by",
              "story.created_by.name",
              "story.resource_subtype",
              "story.text",
              "tag",
              "tag.name",
              "target",
              "target.created_by",
              "target.name",
              "target.resource_subtype",
              "task",
              "task.created_by",
              "task.name",
              "task.resource_subtype",
              "text",
              "type"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "anchor_gid",
                  "assignee",
                  "assignee.name",
                  "comment_gid",
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "custom_field",
                  "custom_field.date_value",
                  "custom_field.date_value.date",
                  "custom_field.date_value.date_time",
                  "custom_field.display_value",
                  "custom_field.enabled",
                  "custom_field.enum_options",
                  "custom_field.enum_options.color",
                  "custom_field.enum_options.enabled",
                  "custom_field.enum_options.name",
                  "custom_field.enum_value",
                  "custom_field.enum_value.color",
                  "custom_field.enum_value.enabled",
                  "custom_field.enum_value.name",
                  "custom_field.id_prefix",
                  "custom_field.input_restrictions",
                  "custom_field.is_formula_field",
                  "custom_field.is_lookup_field",
                  "custom_field.multi_enum_values",
                  "custom_field.multi_enum_values.color",
                  "custom_field.multi_enum_values.enabled",
                  "custom_field.multi_enum_values.name",
                  "custom_field.name",
                  "custom_field.number_value",
                  "custom_field.representation_type",
                  "custom_field.text_value",
                  "custom_field.type",
                  "dependency",
                  "dependency.created_by",
                  "dependency.name",
                  "dependency.resource_subtype",
                  "duplicate_of",
                  "duplicate_of.created_by",
                  "duplicate_of.name",
                  "duplicate_of.resource_subtype",
                  "duplicated_from",
                  "duplicated_from.created_by",
                  "duplicated_from.name",
                  "duplicated_from.resource_subtype",
                  "follower",
                  "follower.name",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_text",
                  "is_editable",
                  "is_edited",
                  "is_pinned",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "new_approval_status",
                  "new_date_value",
                  "new_dates",
                  "new_dates.due_at",
                  "new_dates.due_on",
                  "new_dates.start_on",
                  "new_enum_value",
                  "new_enum_value.color",
                  "new_enum_value.enabled",
                  "new_enum_value.name",
                  "new_multi_enum_values",
                  "new_multi_enum_values.color",
                  "new_multi_enum_values.enabled",
                  "new_multi_enum_values.name",
                  "new_name",
                  "new_number_value",
                  "new_people_value",
                  "new_people_value.name",
                  "new_resource_subtype",
                  "new_section",
                  "new_section.name",
                  "new_text_value",
                  "num_hearts",
                  "num_likes",
                  "old_approval_status",
                  "old_date_value",
                  "old_dates",
                  "old_dates.due_at",
                  "old_dates.due_on",
                  "old_dates.start_on",
                  "old_enum_value",
                  "old_enum_value.color",
                  "old_enum_value.enabled",
                  "old_enum_value.name",
                  "old_multi_enum_values",
                  "old_multi_enum_values.color",
                  "old_multi_enum_values.enabled",
                  "old_multi_enum_values.name",
                  "old_name",
                  "old_number_value",
                  "old_people_value",
                  "old_people_value.name",
                  "old_resource_subtype",
                  "old_section",
                  "old_section.name",
                  "old_text_value",
                  "previews",
                  "previews.fallback",
                  "previews.footer",
                  "previews.header",
                  "previews.header_link",
                  "previews.html_text",
                  "previews.text",
                  "previews.title",
                  "previews.title_link",
                  "project",
                  "project.name",
                  "project.resource_subtype",
                  "reaction_summary",
                  "reaction_summary.count",
                  "reaction_summary.emoji_base",
                  "reaction_summary.reacted",
                  "reaction_summary.variant",
                  "resource_subtype",
                  "source",
                  "sticker_name",
                  "story",
                  "story.anchor_gid",
                  "story.comment_gid",
                  "story.created_at",
                  "story.created_by",
                  "story.created_by.name",
                  "story.resource_subtype",
                  "story.text",
                  "tag",
                  "tag.name",
                  "target",
                  "target.created_by",
                  "target.name",
                  "target.resource_subtype",
                  "task",
                  "task.created_by",
                  "task.name",
                  "task.resource_subtype",
                  "text",
                  "type"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/StoryResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__StoryResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the specified story."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "stories:read"
            ]
          }
        ],
        "summary": "Get a story",
        "tags": [
          "Stories"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1stories~1{story_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nStory result = client.stories.getStory(storyGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet storiesApiInstance = new Asana.StoriesApi(client);\nlet story_gid = \"35678\"; // String | Globally unique identifier for the story.\nlet opts = { \n    'opt_fields': \"anchor_gid,assignee,assignee.name,comment_gid,created_at,created_by,created_by.name,custom_field,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_lookup_field,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.representation_type,custom_field.text_value,custom_field.type,dependency,dependency.created_by,dependency.name,dependency.resource_subtype,duplicate_of,duplicate_of.created_by,duplicate_of.name,duplicate_of.resource_subtype,duplicated_from,duplicated_from.created_by,duplicated_from.name,duplicated_from.resource_subtype,follower,follower.name,hearted,hearts,hearts.user,hearts.user.name,html_text,is_editable,is_edited,is_pinned,liked,likes,likes.user,likes.user.name,new_approval_status,new_date_value,new_dates,new_dates.due_at,new_dates.due_on,new_dates.start_on,new_enum_value,new_enum_value.color,new_enum_value.enabled,new_enum_value.name,new_multi_enum_values,new_multi_enum_values.color,new_multi_enum_values.enabled,new_multi_enum_values.name,new_name,new_number_value,new_people_value,new_people_value.name,new_resource_subtype,new_section,new_section.name,new_text_value,num_hearts,num_likes,old_approval_status,old_date_value,old_dates,old_dates.due_at,old_dates.due_on,old_dates.start_on,old_enum_value,old_enum_value.color,old_enum_value.enabled,old_enum_value.name,old_multi_enum_values,old_multi_enum_values.color,old_multi_enum_values.enabled,old_multi_enum_values.name,old_name,old_number_value,old_people_value,old_people_value.name,old_resource_subtype,old_section,old_section.name,old_text_value,previews,previews.fallback,previews.footer,previews.header,previews.header_link,previews.html_text,previews.text,previews.title,previews.title_link,project,project.name,project.resource_subtype,reaction_summary,reaction_summary.count,reaction_summary.emoji_base,reaction_summary.reacted,reaction_summary.variant,resource_subtype,source,sticker_name,story,story.anchor_gid,story.comment_gid,story.created_at,story.created_by,story.created_by.name,story.resource_subtype,story.text,tag,tag.name,target,target.created_by,target.name,target.resource_subtype,task,task.created_by,task.name,task.resource_subtype,text,type\"\n};\nstoriesApiInstance.getStory(story_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.stories.getStory(storyGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nstories_api_instance = asana.StoriesApi(api_client)\nstory_gid = \"35678\" # str | Globally unique identifier for the story.\nopts = {\n    'opt_fields': \"anchor_gid,assignee,assignee.name,comment_gid,created_at,created_by,created_by.name,custom_field,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_lookup_field,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.representation_type,custom_field.text_value,custom_field.type,dependency,dependency.created_by,dependency.name,dependency.resource_subtype,duplicate_of,duplicate_of.created_by,duplicate_of.name,duplicate_of.resource_subtype,duplicated_from,duplicated_from.created_by,duplicated_from.name,duplicated_from.resource_subtype,follower,follower.name,hearted,hearts,hearts.user,hearts.user.name,html_text,is_editable,is_edited,is_pinned,liked,likes,likes.user,likes.user.name,new_approval_status,new_date_value,new_dates,new_dates.due_at,new_dates.due_on,new_dates.start_on,new_enum_value,new_enum_value.color,new_enum_value.enabled,new_enum_value.name,new_multi_enum_values,new_multi_enum_values.color,new_multi_enum_values.enabled,new_multi_enum_values.name,new_name,new_number_value,new_people_value,new_people_value.name,new_resource_subtype,new_section,new_section.name,new_text_value,num_hearts,num_likes,old_approval_status,old_date_value,old_dates,old_dates.due_at,old_dates.due_on,old_dates.start_on,old_enum_value,old_enum_value.color,old_enum_value.enabled,old_enum_value.name,old_multi_enum_values,old_multi_enum_values.color,old_multi_enum_values.enabled,old_multi_enum_values.name,old_name,old_number_value,old_people_value,old_people_value.name,old_resource_subtype,old_section,old_section.name,old_text_value,previews,previews.fallback,previews.footer,previews.header,previews.header_link,previews.html_text,previews.text,previews.title,previews.title_link,project,project.name,project.resource_subtype,reaction_summary,reaction_summary.count,reaction_summary.emoji_base,reaction_summary.reacted,reaction_summary.variant,resource_subtype,source,sticker_name,story,story.anchor_gid,story.comment_gid,story.created_at,story.created_by,story.created_by.name,story.resource_subtype,story.text,tag,tag.name,target,target.created_by,target.name,target.resource_subtype,task,task.created_by,task.name,task.resource_subtype,text,type\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a story\n    api_response = stories_api_instance.get_story(story_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling StoriesApi->get_story: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.stories.get_story(story_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->stories->getStory($story_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.stories.get_story(story_gid: 'story_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/story_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "put": {
        "description": "<b>Required scope: </b><code>stories:write</code>\n\nUpdates the story and returns the full record for the updated story. Only comment stories can have their text updated, and only comment stories and attachment stories can be pinned. Only one of `text` and `html_text` can be specified.",
        "operationId": "updateStory",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "anchor_gid",
              "assignee",
              "assignee.name",
              "comment_gid",
              "created_at",
              "created_by",
              "created_by.name",
              "custom_field",
              "custom_field.date_value",
              "custom_field.date_value.date",
              "custom_field.date_value.date_time",
              "custom_field.display_value",
              "custom_field.enabled",
              "custom_field.enum_options",
              "custom_field.enum_options.color",
              "custom_field.enum_options.enabled",
              "custom_field.enum_options.name",
              "custom_field.enum_value",
              "custom_field.enum_value.color",
              "custom_field.enum_value.enabled",
              "custom_field.enum_value.name",
              "custom_field.id_prefix",
              "custom_field.input_restrictions",
              "custom_field.is_formula_field",
              "custom_field.is_lookup_field",
              "custom_field.multi_enum_values",
              "custom_field.multi_enum_values.color",
              "custom_field.multi_enum_values.enabled",
              "custom_field.multi_enum_values.name",
              "custom_field.name",
              "custom_field.number_value",
              "custom_field.representation_type",
              "custom_field.text_value",
              "custom_field.type",
              "dependency",
              "dependency.created_by",
              "dependency.name",
              "dependency.resource_subtype",
              "duplicate_of",
              "duplicate_of.created_by",
              "duplicate_of.name",
              "duplicate_of.resource_subtype",
              "duplicated_from",
              "duplicated_from.created_by",
              "duplicated_from.name",
              "duplicated_from.resource_subtype",
              "follower",
              "follower.name",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_text",
              "is_editable",
              "is_edited",
              "is_pinned",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "new_approval_status",
              "new_date_value",
              "new_dates",
              "new_dates.due_at",
              "new_dates.due_on",
              "new_dates.start_on",
              "new_enum_value",
              "new_enum_value.color",
              "new_enum_value.enabled",
              "new_enum_value.name",
              "new_multi_enum_values",
              "new_multi_enum_values.color",
              "new_multi_enum_values.enabled",
              "new_multi_enum_values.name",
              "new_name",
              "new_number_value",
              "new_people_value",
              "new_people_value.name",
              "new_resource_subtype",
              "new_section",
              "new_section.name",
              "new_text_value",
              "num_hearts",
              "num_likes",
              "old_approval_status",
              "old_date_value",
              "old_dates",
              "old_dates.due_at",
              "old_dates.due_on",
              "old_dates.start_on",
              "old_enum_value",
              "old_enum_value.color",
              "old_enum_value.enabled",
              "old_enum_value.name",
              "old_multi_enum_values",
              "old_multi_enum_values.color",
              "old_multi_enum_values.enabled",
              "old_multi_enum_values.name",
              "old_name",
              "old_number_value",
              "old_people_value",
              "old_people_value.name",
              "old_resource_subtype",
              "old_section",
              "old_section.name",
              "old_text_value",
              "previews",
              "previews.fallback",
              "previews.footer",
              "previews.header",
              "previews.header_link",
              "previews.html_text",
              "previews.text",
              "previews.title",
              "previews.title_link",
              "project",
              "project.name",
              "project.resource_subtype",
              "reaction_summary",
              "reaction_summary.count",
              "reaction_summary.emoji_base",
              "reaction_summary.reacted",
              "reaction_summary.variant",
              "resource_subtype",
              "source",
              "sticker_name",
              "story",
              "story.anchor_gid",
              "story.comment_gid",
              "story.created_at",
              "story.created_by",
              "story.created_by.name",
              "story.resource_subtype",
              "story.text",
              "tag",
              "tag.name",
              "target",
              "target.created_by",
              "target.name",
              "target.resource_subtype",
              "task",
              "task.created_by",
              "task.name",
              "task.resource_subtype",
              "text",
              "type"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "anchor_gid",
                  "assignee",
                  "assignee.name",
                  "comment_gid",
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "custom_field",
                  "custom_field.date_value",
                  "custom_field.date_value.date",
                  "custom_field.date_value.date_time",
                  "custom_field.display_value",
                  "custom_field.enabled",
                  "custom_field.enum_options",
                  "custom_field.enum_options.color",
                  "custom_field.enum_options.enabled",
                  "custom_field.enum_options.name",
                  "custom_field.enum_value",
                  "custom_field.enum_value.color",
                  "custom_field.enum_value.enabled",
                  "custom_field.enum_value.name",
                  "custom_field.id_prefix",
                  "custom_field.input_restrictions",
                  "custom_field.is_formula_field",
                  "custom_field.is_lookup_field",
                  "custom_field.multi_enum_values",
                  "custom_field.multi_enum_values.color",
                  "custom_field.multi_enum_values.enabled",
                  "custom_field.multi_enum_values.name",
                  "custom_field.name",
                  "custom_field.number_value",
                  "custom_field.representation_type",
                  "custom_field.text_value",
                  "custom_field.type",
                  "dependency",
                  "dependency.created_by",
                  "dependency.name",
                  "dependency.resource_subtype",
                  "duplicate_of",
                  "duplicate_of.created_by",
                  "duplicate_of.name",
                  "duplicate_of.resource_subtype",
                  "duplicated_from",
                  "duplicated_from.created_by",
                  "duplicated_from.name",
                  "duplicated_from.resource_subtype",
                  "follower",
                  "follower.name",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_text",
                  "is_editable",
                  "is_edited",
                  "is_pinned",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "new_approval_status",
                  "new_date_value",
                  "new_dates",
                  "new_dates.due_at",
                  "new_dates.due_on",
                  "new_dates.start_on",
                  "new_enum_value",
                  "new_enum_value.color",
                  "new_enum_value.enabled",
                  "new_enum_value.name",
                  "new_multi_enum_values",
                  "new_multi_enum_values.color",
                  "new_multi_enum_values.enabled",
                  "new_multi_enum_values.name",
                  "new_name",
                  "new_number_value",
                  "new_people_value",
                  "new_people_value.name",
                  "new_resource_subtype",
                  "new_section",
                  "new_section.name",
                  "new_text_value",
                  "num_hearts",
                  "num_likes",
                  "old_approval_status",
                  "old_date_value",
                  "old_dates",
                  "old_dates.due_at",
                  "old_dates.due_on",
                  "old_dates.start_on",
                  "old_enum_value",
                  "old_enum_value.color",
                  "old_enum_value.enabled",
                  "old_enum_value.name",
                  "old_multi_enum_values",
                  "old_multi_enum_values.color",
                  "old_multi_enum_values.enabled",
                  "old_multi_enum_values.name",
                  "old_name",
                  "old_number_value",
                  "old_people_value",
                  "old_people_value.name",
                  "old_resource_subtype",
                  "old_section",
                  "old_section.name",
                  "old_text_value",
                  "previews",
                  "previews.fallback",
                  "previews.footer",
                  "previews.header",
                  "previews.header_link",
                  "previews.html_text",
                  "previews.text",
                  "previews.title",
                  "previews.title_link",
                  "project",
                  "project.name",
                  "project.resource_subtype",
                  "reaction_summary",
                  "reaction_summary.count",
                  "reaction_summary.emoji_base",
                  "reaction_summary.reacted",
                  "reaction_summary.variant",
                  "resource_subtype",
                  "source",
                  "sticker_name",
                  "story",
                  "story.anchor_gid",
                  "story.comment_gid",
                  "story.created_at",
                  "story.created_by",
                  "story.created_by.name",
                  "story.resource_subtype",
                  "story.text",
                  "tag",
                  "tag.name",
                  "target",
                  "target.created_by",
                  "target.name",
                  "target.resource_subtype",
                  "task",
                  "task.created_by",
                  "task.name",
                  "task.resource_subtype",
                  "text",
                  "type"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/StoryRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The comment story to update.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/StoryResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__StoryResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the specified story."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "stories:write"
            ]
          }
        ],
        "summary": "Update a story",
        "tags": [
          "Stories"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1stories~1{story_gid}/put",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nStory result = client.stories.updateStory(storyGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet storiesApiInstance = new Asana.StoriesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The comment story to update.\nlet story_gid = \"35678\"; // String | Globally unique identifier for the story.\nlet opts = { \n    'opt_fields': \"anchor_gid,assignee,assignee.name,comment_gid,created_at,created_by,created_by.name,custom_field,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_lookup_field,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.representation_type,custom_field.text_value,custom_field.type,dependency,dependency.created_by,dependency.name,dependency.resource_subtype,duplicate_of,duplicate_of.created_by,duplicate_of.name,duplicate_of.resource_subtype,duplicated_from,duplicated_from.created_by,duplicated_from.name,duplicated_from.resource_subtype,follower,follower.name,hearted,hearts,hearts.user,hearts.user.name,html_text,is_editable,is_edited,is_pinned,liked,likes,likes.user,likes.user.name,new_approval_status,new_date_value,new_dates,new_dates.due_at,new_dates.due_on,new_dates.start_on,new_enum_value,new_enum_value.color,new_enum_value.enabled,new_enum_value.name,new_multi_enum_values,new_multi_enum_values.color,new_multi_enum_values.enabled,new_multi_enum_values.name,new_name,new_number_value,new_people_value,new_people_value.name,new_resource_subtype,new_section,new_section.name,new_text_value,num_hearts,num_likes,old_approval_status,old_date_value,old_dates,old_dates.due_at,old_dates.due_on,old_dates.start_on,old_enum_value,old_enum_value.color,old_enum_value.enabled,old_enum_value.name,old_multi_enum_values,old_multi_enum_values.color,old_multi_enum_values.enabled,old_multi_enum_values.name,old_name,old_number_value,old_people_value,old_people_value.name,old_resource_subtype,old_section,old_section.name,old_text_value,previews,previews.fallback,previews.footer,previews.header,previews.header_link,previews.html_text,previews.text,previews.title,previews.title_link,project,project.name,project.resource_subtype,reaction_summary,reaction_summary.count,reaction_summary.emoji_base,reaction_summary.reacted,reaction_summary.variant,resource_subtype,source,sticker_name,story,story.anchor_gid,story.comment_gid,story.created_at,story.created_by,story.created_by.name,story.resource_subtype,story.text,tag,tag.name,target,target.created_by,target.name,target.resource_subtype,task,task.created_by,task.name,task.resource_subtype,text,type\"\n};\nstoriesApiInstance.updateStory(body, story_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.stories.updateStory(storyGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nstories_api_instance = asana.StoriesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The comment story to update.\nstory_gid = \"35678\" # str | Globally unique identifier for the story.\nopts = {\n    'opt_fields': \"anchor_gid,assignee,assignee.name,comment_gid,created_at,created_by,created_by.name,custom_field,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_lookup_field,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.representation_type,custom_field.text_value,custom_field.type,dependency,dependency.created_by,dependency.name,dependency.resource_subtype,duplicate_of,duplicate_of.created_by,duplicate_of.name,duplicate_of.resource_subtype,duplicated_from,duplicated_from.created_by,duplicated_from.name,duplicated_from.resource_subtype,follower,follower.name,hearted,hearts,hearts.user,hearts.user.name,html_text,is_editable,is_edited,is_pinned,liked,likes,likes.user,likes.user.name,new_approval_status,new_date_value,new_dates,new_dates.due_at,new_dates.due_on,new_dates.start_on,new_enum_value,new_enum_value.color,new_enum_value.enabled,new_enum_value.name,new_multi_enum_values,new_multi_enum_values.color,new_multi_enum_values.enabled,new_multi_enum_values.name,new_name,new_number_value,new_people_value,new_people_value.name,new_resource_subtype,new_section,new_section.name,new_text_value,num_hearts,num_likes,old_approval_status,old_date_value,old_dates,old_dates.due_at,old_dates.due_on,old_dates.start_on,old_enum_value,old_enum_value.color,old_enum_value.enabled,old_enum_value.name,old_multi_enum_values,old_multi_enum_values.color,old_multi_enum_values.enabled,old_multi_enum_values.name,old_name,old_number_value,old_people_value,old_people_value.name,old_resource_subtype,old_section,old_section.name,old_text_value,previews,previews.fallback,previews.footer,previews.header,previews.header_link,previews.html_text,previews.text,previews.title,previews.title_link,project,project.name,project.resource_subtype,reaction_summary,reaction_summary.count,reaction_summary.emoji_base,reaction_summary.reacted,reaction_summary.variant,resource_subtype,source,sticker_name,story,story.anchor_gid,story.comment_gid,story.created_at,story.created_by,story.created_by.name,story.resource_subtype,story.text,tag,tag.name,target,target.created_by,target.name,target.resource_subtype,task,task.created_by,task.name,task.resource_subtype,text,type\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Update a story\n    api_response = stories_api_instance.update_story(body, story_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling StoriesApi->update_story: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.stories.update_story(story_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->stories->updateStory($story_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.stories.update_story(story_gid: 'story_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/tables": {
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>tables:write</code>\n\nCreates a new table in a workspace.\n\nReturns the full record of the newly created table.",
        "operationId": "createTable",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_at",
              "custom_field_settings",
              "custom_field_settings.custom_field",
              "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.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.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.representation_type",
              "custom_field_settings.custom_field.text_value",
              "custom_field_settings.custom_field.type",
              "custom_field_settings.is_important",
              "default_access_level",
              "modified_at",
              "name",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_at",
                  "custom_field_settings",
                  "custom_field_settings.custom_field",
                  "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.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.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.representation_type",
                  "custom_field_settings.custom_field.text_value",
                  "custom_field_settings.custom_field.type",
                  "custom_field_settings.is_important",
                  "default_access_level",
                  "modified_at",
                  "name",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TableRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The table to create.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TableResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TableResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created the table."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tables:write"
            ]
          }
        ],
        "summary": "Create a table",
        "tags": [
          "Tables"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tables/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tablesApiInstance = new Asana.TablesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The table to create.\nlet opts = { \n    'opt_fields': \"created_at,custom_field_settings,custom_field_settings.custom_field,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.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.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_lookup_field,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.representation_type,custom_field_settings.custom_field.text_value,custom_field_settings.custom_field.type,custom_field_settings.is_important,modified_at,name,workspace,workspace.name\"\n};\ntablesApiInstance.createTable(body, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ntables_api_instance = asana.TablesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The table to create.\nopts = {\n    'opt_fields': \"created_at,custom_field_settings,custom_field_settings.custom_field,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.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.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_lookup_field,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.representation_type,custom_field_settings.custom_field.text_value,custom_field_settings.custom_field.type,custom_field_settings.is_important,modified_at,name,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create a table\n    api_response = tables_api_instance.create_table(body, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TablesApi->create_table: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/tables/{table_gid}": {
      "delete": {
        "description": "<b>Required scope: </b><code>tables:delete</code>\n\nA specific, existing table can be deleted by making a DELETE request\non the URL for that table.\n\nReturns an empty data record.",
        "operationId": "deleteTable",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully deleted the specified table."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tables:delete"
            ]
          }
        ],
        "summary": "Delete a table",
        "tags": [
          "Tables"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tables~1{table_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tablesApiInstance = new Asana.TablesApi(client);\nlet table_gid = \"1337\"; // String | Globally unique identifier for the table.\n\ntablesApiInstance.deleteTable(table_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ntables_api_instance = asana.TablesApi(api_client)\ntable_gid = \"1337\" # str | Globally unique identifier for the table.\n\n\ntry:\n    # Delete a table\n    api_response = tables_api_instance.delete_table(table_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TablesApi->delete_table: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "get": {
        "description": "<b>Required scope: </b><code>tables:read</code>\n\nReturns the complete table record for a single table.",
        "operationId": "getTable",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_at",
              "custom_field_settings",
              "custom_field_settings.custom_field",
              "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.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.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.representation_type",
              "custom_field_settings.custom_field.text_value",
              "custom_field_settings.custom_field.type",
              "custom_field_settings.is_important",
              "default_access_level",
              "modified_at",
              "name",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_at",
                  "custom_field_settings",
                  "custom_field_settings.custom_field",
                  "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.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.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.representation_type",
                  "custom_field_settings.custom_field.text_value",
                  "custom_field_settings.custom_field.type",
                  "custom_field_settings.is_important",
                  "default_access_level",
                  "modified_at",
                  "name",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TableResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TableResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested table."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tables:read"
            ]
          }
        ],
        "summary": "Get a table",
        "tags": [
          "Tables"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tables~1{table_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tablesApiInstance = new Asana.TablesApi(client);\nlet table_gid = \"1337\"; // String | Globally unique identifier for the table.\nlet opts = { \n    'opt_fields': \"created_at,custom_field_settings,custom_field_settings.custom_field,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.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.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_lookup_field,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.representation_type,custom_field_settings.custom_field.text_value,custom_field_settings.custom_field.type,custom_field_settings.is_important,modified_at,name,workspace,workspace.name\"\n};\ntablesApiInstance.getTable(table_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ntables_api_instance = asana.TablesApi(api_client)\ntable_gid = \"1337\" # str | Globally unique identifier for the table.\nopts = {\n    'opt_fields': \"created_at,custom_field_settings,custom_field_settings.custom_field,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.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.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_lookup_field,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.representation_type,custom_field_settings.custom_field.text_value,custom_field_settings.custom_field.type,custom_field_settings.is_important,modified_at,name,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a table\n    api_response = tables_api_instance.get_table(table_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TablesApi->get_table: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/table_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/tables/{table_gid}/addCustomFieldSetting": {
      "parameters": [
        {
          "$ref": "#/components/parameters/table_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>tables:write</code>\n\nCustom fields are associated with tables by way of custom field settings. This method creates a setting for the table.\nUnlike projects and portfolios, tables only support custom fields that are global (published) to the workspace. Reusing a non-global custom field, or creating a new field inline that isn't global, will fail with a `403 Forbidden` error.",
        "operationId": "addCustomFieldSettingForTable",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "custom_field",
              "custom_field.date_value",
              "custom_field.date_value.date",
              "custom_field.date_value.date_time",
              "custom_field.display_value",
              "custom_field.enabled",
              "custom_field.enum_options",
              "custom_field.enum_options.color",
              "custom_field.enum_options.enabled",
              "custom_field.enum_options.name",
              "custom_field.enum_value",
              "custom_field.enum_value.color",
              "custom_field.enum_value.enabled",
              "custom_field.enum_value.name",
              "custom_field.id_prefix",
              "custom_field.input_restrictions",
              "custom_field.is_formula_field",
              "custom_field.is_lookup_field",
              "custom_field.multi_enum_values",
              "custom_field.multi_enum_values.color",
              "custom_field.multi_enum_values.enabled",
              "custom_field.multi_enum_values.name",
              "custom_field.name",
              "custom_field.number_value",
              "custom_field.representation_type",
              "custom_field.text_value",
              "custom_field.type",
              "is_important"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "custom_field",
                  "custom_field.date_value",
                  "custom_field.date_value.date",
                  "custom_field.date_value.date_time",
                  "custom_field.display_value",
                  "custom_field.enabled",
                  "custom_field.enum_options",
                  "custom_field.enum_options.color",
                  "custom_field.enum_options.enabled",
                  "custom_field.enum_options.name",
                  "custom_field.enum_value",
                  "custom_field.enum_value.color",
                  "custom_field.enum_value.enabled",
                  "custom_field.enum_value.name",
                  "custom_field.id_prefix",
                  "custom_field.input_restrictions",
                  "custom_field.is_formula_field",
                  "custom_field.is_lookup_field",
                  "custom_field.multi_enum_values",
                  "custom_field.multi_enum_values.color",
                  "custom_field.multi_enum_values.enabled",
                  "custom_field.multi_enum_values.name",
                  "custom_field.name",
                  "custom_field.number_value",
                  "custom_field.representation_type",
                  "custom_field.text_value",
                  "custom_field.type",
                  "is_important"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/AddCustomFieldSettingRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Information about the custom field setting.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/CustomFieldTableSettingResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__CustomFieldTableSettingResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully added the custom field to the table."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tables:write"
            ]
          }
        ],
        "summary": "Add a custom field to a table",
        "tags": [
          "Tables"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tables~1{table_gid}~1addCustomFieldSetting/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tablesApiInstance = new Asana.TablesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | Information about the custom field setting.\nlet table_gid = \"1337\"; // String | Globally unique identifier for the table.\nlet opts = { \n    'opt_fields': \"custom_field,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_lookup_field,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.representation_type,custom_field.text_value,custom_field.type,is_important\"\n};\ntablesApiInstance.addCustomFieldSettingForTable(body, table_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ntables_api_instance = asana.TablesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | Information about the custom field setting.\ntable_gid = \"1337\" # str | Globally unique identifier for the table.\nopts = {\n    'opt_fields': \"custom_field,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_lookup_field,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.representation_type,custom_field.text_value,custom_field.type,is_important\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Add a custom field to a table\n    api_response = tables_api_instance.add_custom_field_setting_for_table(body, table_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TablesApi->add_custom_field_setting_for_table: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/tables/{table_gid}/custom_field_settings": {
      "get": {
        "description": "<b>Required scope: </b><code>tables:read</code>\n\nReturns a paginated list of the custom field settings for the given table.",
        "operationId": "getCustomFieldSettingsForTable",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "custom_field",
              "custom_field.date_value",
              "custom_field.date_value.date",
              "custom_field.date_value.date_time",
              "custom_field.display_value",
              "custom_field.enabled",
              "custom_field.enum_options",
              "custom_field.enum_options.color",
              "custom_field.enum_options.enabled",
              "custom_field.enum_options.name",
              "custom_field.enum_value",
              "custom_field.enum_value.color",
              "custom_field.enum_value.enabled",
              "custom_field.enum_value.name",
              "custom_field.id_prefix",
              "custom_field.input_restrictions",
              "custom_field.is_formula_field",
              "custom_field.is_lookup_field",
              "custom_field.multi_enum_values",
              "custom_field.multi_enum_values.color",
              "custom_field.multi_enum_values.enabled",
              "custom_field.multi_enum_values.name",
              "custom_field.name",
              "custom_field.number_value",
              "custom_field.representation_type",
              "custom_field.text_value",
              "custom_field.type",
              "is_important",
              "offset",
              "path",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "custom_field",
                  "custom_field.date_value",
                  "custom_field.date_value.date",
                  "custom_field.date_value.date_time",
                  "custom_field.display_value",
                  "custom_field.enabled",
                  "custom_field.enum_options",
                  "custom_field.enum_options.color",
                  "custom_field.enum_options.enabled",
                  "custom_field.enum_options.name",
                  "custom_field.enum_value",
                  "custom_field.enum_value.color",
                  "custom_field.enum_value.enabled",
                  "custom_field.enum_value.name",
                  "custom_field.id_prefix",
                  "custom_field.input_restrictions",
                  "custom_field.is_formula_field",
                  "custom_field.is_lookup_field",
                  "custom_field.multi_enum_values",
                  "custom_field.multi_enum_values.color",
                  "custom_field.multi_enum_values.enabled",
                  "custom_field.multi_enum_values.name",
                  "custom_field.name",
                  "custom_field.number_value",
                  "custom_field.representation_type",
                  "custom_field.text_value",
                  "custom_field.type",
                  "is_important",
                  "offset",
                  "path",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/CustomFieldTableSettingResponse"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__CustomFieldTableSettingResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the table's custom field settings."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tables:read"
            ]
          }
        ],
        "summary": "Get a table's custom field settings",
        "tags": [
          "Tables"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tables~1{table_gid}~1custom_field_settings/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tablesApiInstance = new Asana.TablesApi(client);\nlet table_gid = \"1337\"; // String | Globally unique identifier for the table.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"custom_field,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_lookup_field,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.representation_type,custom_field.text_value,custom_field.type,is_important,offset,path,uri\"\n};\ntablesApiInstance.getCustomFieldSettingsForTable(table_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ntables_api_instance = asana.TablesApi(api_client)\ntable_gid = \"1337\" # str | Globally unique identifier for the table.\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    'opt_fields': \"custom_field,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_lookup_field,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.representation_type,custom_field.text_value,custom_field.type,is_important,offset,path,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a table's custom field settings\n    api_response = tables_api_instance.get_custom_field_settings_for_table(table_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TablesApi->get_custom_field_settings_for_table: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/table_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/tables/{table_gid}/getCustomFieldSettings": {
      "get": {
        "deprecated": true,
        "description": "<b>Required scope: </b><code>tables:read</code>\n\nReturns a paginated list of the custom field settings for the given table.\n\nDeprecated in favor of [Get a table's custom field settings](/reference/getcustomfieldsettingsfortable), which is otherwise identical. Kept for existing callers; new integrations should use the other endpoint instead.",
        "operationId": "getCustomFieldSettingsForTableLegacy",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "custom_field",
              "custom_field.date_value",
              "custom_field.date_value.date",
              "custom_field.date_value.date_time",
              "custom_field.display_value",
              "custom_field.enabled",
              "custom_field.enum_options",
              "custom_field.enum_options.color",
              "custom_field.enum_options.enabled",
              "custom_field.enum_options.name",
              "custom_field.enum_value",
              "custom_field.enum_value.color",
              "custom_field.enum_value.enabled",
              "custom_field.enum_value.name",
              "custom_field.id_prefix",
              "custom_field.input_restrictions",
              "custom_field.is_formula_field",
              "custom_field.is_lookup_field",
              "custom_field.multi_enum_values",
              "custom_field.multi_enum_values.color",
              "custom_field.multi_enum_values.enabled",
              "custom_field.multi_enum_values.name",
              "custom_field.name",
              "custom_field.number_value",
              "custom_field.representation_type",
              "custom_field.text_value",
              "custom_field.type",
              "is_important",
              "offset",
              "path",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "custom_field",
                  "custom_field.date_value",
                  "custom_field.date_value.date",
                  "custom_field.date_value.date_time",
                  "custom_field.display_value",
                  "custom_field.enabled",
                  "custom_field.enum_options",
                  "custom_field.enum_options.color",
                  "custom_field.enum_options.enabled",
                  "custom_field.enum_options.name",
                  "custom_field.enum_value",
                  "custom_field.enum_value.color",
                  "custom_field.enum_value.enabled",
                  "custom_field.enum_value.name",
                  "custom_field.id_prefix",
                  "custom_field.input_restrictions",
                  "custom_field.is_formula_field",
                  "custom_field.is_lookup_field",
                  "custom_field.multi_enum_values",
                  "custom_field.multi_enum_values.color",
                  "custom_field.multi_enum_values.enabled",
                  "custom_field.multi_enum_values.name",
                  "custom_field.name",
                  "custom_field.number_value",
                  "custom_field.representation_type",
                  "custom_field.text_value",
                  "custom_field.type",
                  "is_important",
                  "offset",
                  "path",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/CustomFieldTableSettingResponse"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__CustomFieldTableSettingResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the table's custom field settings."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tables:read"
            ]
          }
        ],
        "summary": "Get a table's custom field settings",
        "tags": [
          "Tables"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tables~1{table_gid}~1getCustomFieldSettings/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tablesApiInstance = new Asana.TablesApi(client);\nlet table_gid = \"1337\"; // String | Globally unique identifier for the table.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"custom_field,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_lookup_field,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.representation_type,custom_field.text_value,custom_field.type,is_important,offset,path,uri\"\n};\ntablesApiInstance.getCustomFieldSettingsForTableLegacy(table_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ntables_api_instance = asana.TablesApi(api_client)\ntable_gid = \"1337\" # str | Globally unique identifier for the table.\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    'opt_fields': \"custom_field,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_lookup_field,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.representation_type,custom_field.text_value,custom_field.type,is_important,offset,path,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a table's custom field settings\n    api_response = tables_api_instance.get_custom_field_settings_for_table_legacy(table_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TablesApi->get_custom_field_settings_for_table_legacy: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/table_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/tables/{table_gid}/records": {
      "get": {
        "description": "<b>Required scope: </b><code>records:read</code>\n\nReturns the compact records for all records in the given table.",
        "operationId": "getRecordsForTable",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "Only return records that have been modified since the given time.",
            "example": "2012-02-22T02:06:58.147Z",
            "in": "query",
            "name": "modified_since",
            "schema": {
              "format": "date-time",
              "type": "string"
            }
          },
          {
            "description": "Sort order for the records returned. If omitted, records are returned in their default order.",
            "example": "created_at",
            "in": "query",
            "name": "sort_by",
            "schema": {
              "enum": [
                "created_at"
              ],
              "type": "string"
            }
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "comment_count",
              "created_at",
              "created_by",
              "created_by.name",
              "custom_fields",
              "custom_fields.asana_created_field",
              "custom_fields.created_by",
              "custom_fields.created_by.name",
              "custom_fields.currency_code",
              "custom_fields.custom_label",
              "custom_fields.custom_label_position",
              "custom_fields.date_value",
              "custom_fields.date_value.date",
              "custom_fields.date_value.date_time",
              "custom_fields.default_access_level",
              "custom_fields.description",
              "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.format",
              "custom_fields.has_notifications_enabled",
              "custom_fields.html_text_value",
              "custom_fields.id_prefix",
              "custom_fields.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_global_to_workspace",
              "custom_fields.is_lookup_field",
              "custom_fields.is_value_read_only",
              "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.people_value",
              "custom_fields.people_value.name",
              "custom_fields.precision",
              "custom_fields.privacy_setting",
              "custom_fields.reference_value",
              "custom_fields.reference_value.name",
              "custom_fields.representation_type",
              "custom_fields.resource_subtype",
              "custom_fields.text_value",
              "custom_fields.type",
              "default_access_level",
              "deleted_at",
              "is_in_archived_table",
              "modified_at",
              "name",
              "offset",
              "path",
              "permalink_url",
              "table",
              "table.name",
              "uri",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "comment_count",
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "custom_fields",
                  "custom_fields.asana_created_field",
                  "custom_fields.created_by",
                  "custom_fields.created_by.name",
                  "custom_fields.currency_code",
                  "custom_fields.custom_label",
                  "custom_fields.custom_label_position",
                  "custom_fields.date_value",
                  "custom_fields.date_value.date",
                  "custom_fields.date_value.date_time",
                  "custom_fields.default_access_level",
                  "custom_fields.description",
                  "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.format",
                  "custom_fields.has_notifications_enabled",
                  "custom_fields.html_text_value",
                  "custom_fields.id_prefix",
                  "custom_fields.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_global_to_workspace",
                  "custom_fields.is_lookup_field",
                  "custom_fields.is_value_read_only",
                  "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.people_value",
                  "custom_fields.people_value.name",
                  "custom_fields.precision",
                  "custom_fields.privacy_setting",
                  "custom_fields.reference_value",
                  "custom_fields.reference_value.name",
                  "custom_fields.representation_type",
                  "custom_fields.resource_subtype",
                  "custom_fields.text_value",
                  "custom_fields.type",
                  "default_access_level",
                  "deleted_at",
                  "is_in_archived_table",
                  "modified_at",
                  "name",
                  "offset",
                  "path",
                  "permalink_url",
                  "table",
                  "table.name",
                  "uri",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/RecordItemCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__RecordItemResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested table's records."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "records:read"
            ]
          }
        ],
        "summary": "Get records in a table",
        "tags": [
          "Records"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tables~1{table_gid}~1records/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet recordsApiInstance = new Asana.RecordsApi(client);\nlet table_gid = \"1337\"; // String | Globally unique identifier for the table.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'modified_since': \"2012-02-22T02:06:58.147Z\", \n    'sort_by': \"created_at\", \n    'opt_fields': \"comment_count,created_at,created_by,created_by.name,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,deleted_at,is_in_archived_table,modified_at,name,offset,path,permalink_url,table,table.name,uri,workspace,workspace.name\"\n};\nrecordsApiInstance.getRecordsForTable(table_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nrecords_api_instance = asana.RecordsApi(api_client)\ntable_gid = \"1337\" # str | Globally unique identifier for the table.\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    'modified_since': '2012-02-22T02:06:58.147Z', # datetime | Only return records that have been modified since the given time.\n    'sort_by': \"created_at\", # str | Sort order for the records returned. If omitted, records are returned in their default order.\n    'opt_fields': \"comment_count,created_at,created_by,created_by.name,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,deleted_at,is_in_archived_table,modified_at,name,offset,path,permalink_url,table,table.name,uri,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get records in a table\n    api_response = records_api_instance.get_records_for_table(table_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling RecordsApi->get_records_for_table: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/table_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/tables/{table_gid}/removeCustomFieldSetting": {
      "parameters": [
        {
          "$ref": "#/components/parameters/table_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>tables:write</code>\n\nRemoves a custom field setting from a table.",
        "operationId": "removeCustomFieldSettingForTable",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/RemoveCustomFieldSettingRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Information about the custom field setting being removed.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully removed the custom field from the table."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tables:write"
            ]
          }
        ],
        "summary": "Remove a custom field from a table",
        "tags": [
          "Tables"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tables~1{table_gid}~1removeCustomFieldSetting/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tablesApiInstance = new Asana.TablesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | Information about the custom field setting being removed.\nlet table_gid = \"1337\"; // String | Globally unique identifier for the table.\n\ntablesApiInstance.removeCustomFieldSettingForTable(body, table_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ntables_api_instance = asana.TablesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | Information about the custom field setting being removed.\ntable_gid = \"1337\" # str | Globally unique identifier for the table.\n\n\ntry:\n    # Remove a custom field from a table\n    api_response = tables_api_instance.remove_custom_field_setting_for_table(body, table_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TablesApi->remove_custom_field_setting_for_table: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/tags": {
      "get": {
        "description": "<b>Required scope: </b><code>tags:read</code>\n\nReturns the compact tag records for some filtered set of tags. Use one or more of the parameters provided to filter the tags returned.",
        "operationId": "getTags",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "The workspace to filter tags on.",
            "example": "1331",
            "in": "query",
            "name": "workspace",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "color",
              "created_at",
              "followers",
              "followers.name",
              "name",
              "notes",
              "offset",
              "path",
              "permalink_url",
              "uri",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "color",
                  "created_at",
                  "followers",
                  "followers.name",
                  "name",
                  "notes",
                  "offset",
                  "path",
                  "permalink_url",
                  "uri",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TagCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TagResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the specified set of tags."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tags:read"
            ]
          }
        ],
        "summary": "Get multiple tags",
        "tags": [
          "Tags"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tags/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Tag> result = client.tags.getTags(workspace)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tagsApiInstance = new Asana.TagsApi(client);\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'workspace': \"1331\", \n    'opt_fields': \"color,created_at,followers,followers.name,name,notes,offset,path,permalink_url,uri,workspace,workspace.name\"\n};\ntagsApiInstance.getTags(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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tags.getTags({param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntags_api_instance = asana.TagsApi(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 to filter tags on.\n    'opt_fields': \"color,created_at,followers,followers.name,name,notes,offset,path,permalink_url,uri,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get multiple tags\n    api_response = tags_api_instance.get_tags(opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TagsApi->get_tags: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tags.get_tags({'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tags->getTags(array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tags.get_tags(param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>tags:write</code>\n\nCreates a new tag in a workspace or organization.\n\nEvery tag is required to be created in a specific workspace or\norganization, and this cannot be changed once set. Note that you can use\nthe workspace parameter regardless of whether or not it is an\norganization.\n\nReturns the full record of the newly created tag.",
        "operationId": "createTag",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "color",
              "created_at",
              "followers",
              "followers.name",
              "name",
              "notes",
              "permalink_url",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "color",
                  "created_at",
                  "followers",
                  "followers.name",
                  "name",
                  "notes",
                  "permalink_url",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TagCreateRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The tag to create.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TagResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TagResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created the newly specified tag."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tags:write"
            ]
          }
        ],
        "summary": "Create a tag",
        "tags": [
          "Tags"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tags/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nTag result = client.tags.createTag()\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tagsApiInstance = new Asana.TagsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The tag to create.\nlet opts = { \n    'opt_fields': \"color,created_at,followers,followers.name,name,notes,permalink_url,workspace,workspace.name\"\n};\ntagsApiInstance.createTag(body, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tags.createTag({field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntags_api_instance = asana.TagsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The tag to create.\nopts = {\n    'opt_fields': \"color,created_at,followers,followers.name,name,notes,permalink_url,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create a tag\n    api_response = tags_api_instance.create_tag(body, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TagsApi->create_tag: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tags.create_tag({'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tags->createTag(array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tags.create_tag(field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/tags/{tag_gid}": {
      "delete": {
        "description": "A specific, existing tag can be deleted by making a DELETE request on\nthe URL for that tag.\n\nReturns an empty data record.",
        "operationId": "deleteTag",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully deleted the specified tag."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Delete a tag",
        "tags": [
          "Tags"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tags~1{tag_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.tags.deleteTag(tagGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tagsApiInstance = new Asana.TagsApi(client);\nlet tag_gid = \"11235\"; // String | Globally unique identifier for the tag.\n\ntagsApiInstance.deleteTag(tag_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tags.deleteTag(tagGid)\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntags_api_instance = asana.TagsApi(api_client)\ntag_gid = \"11235\" # str | Globally unique identifier for the tag.\n\n\ntry:\n    # Delete a tag\n    api_response = tags_api_instance.delete_tag(tag_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TagsApi->delete_tag: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tags.delete_tag(tag_gid, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tags->deleteTag($tag_gid, array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tags.delete_tag(tag_gid: 'tag_gid', options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "get": {
        "description": "<b>Required scope: </b><code>tags:read</code>\n\nReturns the complete tag record for a single tag.",
        "operationId": "getTag",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "color",
              "created_at",
              "followers",
              "followers.name",
              "name",
              "notes",
              "permalink_url",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "color",
                  "created_at",
                  "followers",
                  "followers.name",
                  "name",
                  "notes",
                  "permalink_url",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TagResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TagResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the specified tag."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tags:read"
            ]
          }
        ],
        "summary": "Get a tag",
        "tags": [
          "Tags"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tags~1{tag_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nTag result = client.tags.getTag(tagGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tagsApiInstance = new Asana.TagsApi(client);\nlet tag_gid = \"11235\"; // String | Globally unique identifier for the tag.\nlet opts = { \n    'opt_fields': \"color,created_at,followers,followers.name,name,notes,permalink_url,workspace,workspace.name\"\n};\ntagsApiInstance.getTag(tag_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tags.getTag(tagGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntags_api_instance = asana.TagsApi(api_client)\ntag_gid = \"11235\" # str | Globally unique identifier for the tag.\nopts = {\n    'opt_fields': \"color,created_at,followers,followers.name,name,notes,permalink_url,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a tag\n    api_response = tags_api_instance.get_tag(tag_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TagsApi->get_tag: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tags.get_tag(tag_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tags->getTag($tag_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tags.get_tag(tag_gid: 'tag_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/tag_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "put": {
        "description": "<b>Required scope: </b><code>tags:write</code>\n\nUpdates the properties of a tag. Only the fields provided in the `data`\nblock will be updated; any unspecified fields will remain unchanged.\n\nWhen using this method, it is best to specify only those fields you wish\nto change, or else you may overwrite changes made by another user since\nyou last retrieved the tag.\n\nReturns the complete updated tag record.",
        "operationId": "updateTag",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "color",
              "created_at",
              "followers",
              "followers.name",
              "name",
              "notes",
              "permalink_url",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "color",
                  "created_at",
                  "followers",
                  "followers.name",
                  "name",
                  "notes",
                  "permalink_url",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TagUpdateRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The tag to update.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TagResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TagResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully updated the specified tag."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tags:write"
            ]
          }
        ],
        "summary": "Update a tag",
        "tags": [
          "Tags"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tags~1{tag_gid}/put",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nTag result = client.tags.updateTag(tagGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tagsApiInstance = new Asana.TagsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The tag to update.\nlet tag_gid = \"11235\"; // String | Globally unique identifier for the tag.\nlet opts = { \n    'opt_fields': \"color,created_at,followers,followers.name,name,notes,permalink_url,workspace,workspace.name\"\n};\ntagsApiInstance.updateTag(body, tag_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tags.updateTag(tagGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntags_api_instance = asana.TagsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The tag to update.\ntag_gid = \"11235\" # str | Globally unique identifier for the tag.\nopts = {\n    'opt_fields': \"color,created_at,followers,followers.name,name,notes,permalink_url,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Update a tag\n    api_response = tags_api_instance.update_tag(body, tag_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TagsApi->update_tag: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tags.update_tag(tag_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tags->updateTag($tag_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tags.update_tag(tag_gid: 'tag_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/tags/{tag_gid}/tasks": {
      "get": {
        "description": "<b>Required scope: </b><code>tasks:read</code>\n\nReturns the compact task records for all tasks with the given tag. Tasks can have more than one tag at a time.",
        "operationId": "getTasksForTag",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "actual_time_minutes",
              "approval_status",
              "assigned_by",
              "assigned_by.name",
              "assignee",
              "assignee.name",
              "assignee_section",
              "assignee_section.name",
              "assignee_status",
              "completed",
              "completed_at",
              "completed_by",
              "completed_by.name",
              "created_at",
              "created_by",
              "custom_fields",
              "custom_fields.asana_created_field",
              "custom_fields.created_by",
              "custom_fields.created_by.name",
              "custom_fields.currency_code",
              "custom_fields.custom_label",
              "custom_fields.custom_label_position",
              "custom_fields.date_value",
              "custom_fields.date_value.date",
              "custom_fields.date_value.date_time",
              "custom_fields.default_access_level",
              "custom_fields.description",
              "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.format",
              "custom_fields.has_notifications_enabled",
              "custom_fields.html_text_value",
              "custom_fields.id_prefix",
              "custom_fields.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_global_to_workspace",
              "custom_fields.is_lookup_field",
              "custom_fields.is_value_read_only",
              "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.people_value",
              "custom_fields.people_value.name",
              "custom_fields.precision",
              "custom_fields.privacy_setting",
              "custom_fields.reference_value",
              "custom_fields.reference_value.name",
              "custom_fields.representation_type",
              "custom_fields.resource_subtype",
              "custom_fields.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "custom_type_status_option",
              "custom_type_status_option.name",
              "dependencies",
              "dependents",
              "due_at",
              "due_on",
              "effective_memberships",
              "external",
              "external.data",
              "followers",
              "followers.name",
              "has_subtasks_date_mismatch",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_notes",
              "is_rendered_as_separator",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "memberships",
              "memberships.project",
              "memberships.project.name",
              "memberships.project.resource_subtype",
              "memberships.section",
              "memberships.section.name",
              "modified_at",
              "name",
              "notes",
              "num_hearts",
              "num_likes",
              "num_subtasks",
              "offset",
              "parent",
              "parent.created_by",
              "parent.name",
              "parent.resource_subtype",
              "path",
              "permalink_url",
              "projects",
              "projects.name",
              "projects.resource_subtype",
              "resource_subtype",
              "start_at",
              "start_on",
              "tags",
              "tags.name",
              "uri",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "actual_time_minutes",
                  "approval_status",
                  "assigned_by",
                  "assigned_by.name",
                  "assignee",
                  "assignee.name",
                  "assignee_section",
                  "assignee_section.name",
                  "assignee_status",
                  "completed",
                  "completed_at",
                  "completed_by",
                  "completed_by.name",
                  "created_at",
                  "created_by",
                  "custom_fields",
                  "custom_fields.asana_created_field",
                  "custom_fields.created_by",
                  "custom_fields.created_by.name",
                  "custom_fields.currency_code",
                  "custom_fields.custom_label",
                  "custom_fields.custom_label_position",
                  "custom_fields.date_value",
                  "custom_fields.date_value.date",
                  "custom_fields.date_value.date_time",
                  "custom_fields.default_access_level",
                  "custom_fields.description",
                  "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.format",
                  "custom_fields.has_notifications_enabled",
                  "custom_fields.html_text_value",
                  "custom_fields.id_prefix",
                  "custom_fields.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_global_to_workspace",
                  "custom_fields.is_lookup_field",
                  "custom_fields.is_value_read_only",
                  "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.people_value",
                  "custom_fields.people_value.name",
                  "custom_fields.precision",
                  "custom_fields.privacy_setting",
                  "custom_fields.reference_value",
                  "custom_fields.reference_value.name",
                  "custom_fields.representation_type",
                  "custom_fields.resource_subtype",
                  "custom_fields.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "custom_type_status_option",
                  "custom_type_status_option.name",
                  "dependencies",
                  "dependents",
                  "due_at",
                  "due_on",
                  "effective_memberships",
                  "external",
                  "external.data",
                  "followers",
                  "followers.name",
                  "has_subtasks_date_mismatch",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_notes",
                  "is_rendered_as_separator",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "memberships",
                  "memberships.project",
                  "memberships.project.name",
                  "memberships.project.resource_subtype",
                  "memberships.section",
                  "memberships.section.name",
                  "modified_at",
                  "name",
                  "notes",
                  "num_hearts",
                  "num_likes",
                  "num_subtasks",
                  "offset",
                  "parent",
                  "parent.created_by",
                  "parent.name",
                  "parent.resource_subtype",
                  "path",
                  "permalink_url",
                  "projects",
                  "projects.name",
                  "projects.resource_subtype",
                  "resource_subtype",
                  "start_at",
                  "start_on",
                  "tags",
                  "tags.name",
                  "uri",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TaskCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TaskResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the tasks associated with the specified tag."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:read"
            ]
          }
        ],
        "summary": "Get tasks from a tag",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tags~1{tag_gid}~1tasks/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Task> result = client.tasks.getTasksForTag(tagGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet tag_gid = \"11235\"; // String | Globally unique identifier for the tag.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,offset,parent,parent.created_by,parent.name,parent.resource_subtype,path,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,uri,workspace,workspace.name\"\n};\ntasksApiInstance.getTasksForTag(tag_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.getTasksForTag(tagGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\ntag_gid = \"11235\" # str | Globally unique identifier for the tag.\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    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,offset,parent,parent.created_by,parent.name,parent.resource_subtype,path,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,uri,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get tasks from a tag\n    api_response = tasks_api_instance.get_tasks_for_tag(tag_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->get_tasks_for_tag: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.get_tasks_for_tag(tag_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->getTasksForTag($tag_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.get_tasks_for_tag(tag_gid: 'tag_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/tag_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/task_templates": {
      "get": {
        "description": "<b>Required scope: </b><code>task_templates:read</code>\n\nReturns the compact task template records for some filtered set of task templates. You must specify a `project`",
        "operationId": "getTaskTemplates",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "The project to filter task templates on.",
            "example": "321654",
            "in": "query",
            "name": "project",
            "schema": {
              "type": "string"
            },
            "x-env-variable": "project"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_at",
              "created_by",
              "name",
              "offset",
              "path",
              "project",
              "template",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_at",
                  "created_by",
                  "name",
                  "offset",
                  "path",
                  "project",
                  "template",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TaskTemplateCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TaskTemplateResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved requested task templates"
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "task_templates:read"
            ]
          }
        ],
        "summary": "Get multiple task templates",
        "tags": [
          "Task templates"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1task_templates/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet taskTemplatesApiInstance = new Asana.TaskTemplatesApi(client);\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'project': \"321654\", \n    'opt_fields': \"created_at,created_by,name,offset,path,project,template,uri\"\n};\ntaskTemplatesApiInstance.getTaskTemplates(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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasktemplates.getTaskTemplates({param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntask_templates_api_instance = asana.TaskTemplatesApi(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    'project': \"321654\", # str | The project to filter task templates on.\n    'opt_fields': \"created_at,created_by,name,offset,path,project,template,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get multiple task templates\n    api_response = task_templates_api_instance.get_task_templates(opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TaskTemplatesApi->get_task_templates: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.task_templates.get_task_templates({'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/task_templates/{task_template_gid}": {
      "delete": {
        "description": "A specific, existing task template can be deleted by making a DELETE request on the URL for that task template. Returns an empty data record.",
        "operationId": "deleteTaskTemplate",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully deleted the specified task template."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Delete a task template",
        "tags": [
          "Task templates"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1task_templates~1{task_template_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet taskTemplatesApiInstance = new Asana.TaskTemplatesApi(client);\nlet task_template_gid = \"1331\"; // String | Globally unique identifier for the task template.\n\ntaskTemplatesApiInstance.deleteTaskTemplate(task_template_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasktemplates.deleteTaskTemplate(taskTemplateGid)\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntask_templates_api_instance = asana.TaskTemplatesApi(api_client)\ntask_template_gid = \"1331\" # str | Globally unique identifier for the task template.\n\n\ntry:\n    # Delete a task template\n    api_response = task_templates_api_instance.delete_task_template(task_template_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TaskTemplatesApi->delete_task_template: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.task_templates.delete_task_template(task_template_gid, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            }
          ]
        }
      },
      "get": {
        "description": "<b>Required scope: </b><code>task_templates:read</code>\n\nReturns the complete task template record for a single task template.",
        "operationId": "getTaskTemplate",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_at",
              "created_by",
              "name",
              "project",
              "template"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_at",
                  "created_by",
                  "name",
                  "project",
                  "template"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TaskTemplateResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TaskTemplateResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved requested task template"
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "task_templates:read"
            ]
          }
        ],
        "summary": "Get a task template",
        "tags": [
          "Task templates"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1task_templates~1{task_template_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet taskTemplatesApiInstance = new Asana.TaskTemplatesApi(client);\nlet task_template_gid = \"1331\"; // String | Globally unique identifier for the task template.\nlet opts = { \n    'opt_fields': \"created_at,created_by,name,project,template\"\n};\ntaskTemplatesApiInstance.getTaskTemplate(task_template_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasktemplates.getTaskTemplate(taskTemplateGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntask_templates_api_instance = asana.TaskTemplatesApi(api_client)\ntask_template_gid = \"1331\" # str | Globally unique identifier for the task template.\nopts = {\n    'opt_fields': \"created_at,created_by,name,project,template\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a task template\n    api_response = task_templates_api_instance.get_task_template(task_template_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TaskTemplatesApi->get_task_template: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.task_templates.get_task_template(task_template_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/task_template_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/task_templates/{task_template_gid}/instantiateTask": {
      "parameters": [
        {
          "$ref": "#/components/parameters/task_template_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "Creates and returns a job that will asynchronously handle the task instantiation.",
        "operationId": "instantiateTask",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "dates_rollup_progress",
              "dates_rollup_progress.total_tasks",
              "dates_rollup_progress.updated_tasks",
              "new_graph_export",
              "new_graph_export.completed_at",
              "new_graph_export.created_at",
              "new_graph_export.download_url",
              "new_portfolio",
              "new_portfolio.name",
              "new_portfolio.resource_subtype",
              "new_project",
              "new_project.name",
              "new_project.resource_subtype",
              "new_project_template",
              "new_project_template.name",
              "new_resource_export",
              "new_resource_export.completed_at",
              "new_resource_export.created_at",
              "new_resource_export.download_url",
              "new_task",
              "new_task.created_by",
              "new_task.name",
              "new_task.resource_subtype",
              "resource_subtype",
              "status"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "dates_rollup_progress",
                  "dates_rollup_progress.total_tasks",
                  "dates_rollup_progress.updated_tasks",
                  "new_graph_export",
                  "new_graph_export.completed_at",
                  "new_graph_export.created_at",
                  "new_graph_export.download_url",
                  "new_portfolio",
                  "new_portfolio.name",
                  "new_portfolio.resource_subtype",
                  "new_project",
                  "new_project.name",
                  "new_project.resource_subtype",
                  "new_project_template",
                  "new_project_template.name",
                  "new_resource_export",
                  "new_resource_export.completed_at",
                  "new_resource_export.created_at",
                  "new_resource_export.download_url",
                  "new_task",
                  "new_task.created_by",
                  "new_task.name",
                  "new_task.resource_subtype",
                  "resource_subtype",
                  "status"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TaskTemplateInstantiateTaskRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Describes the inputs used for instantiating a task - the task's name."
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/JobResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__JobResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created the job to handle task instantiation."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Instantiate a task from a task template",
        "tags": [
          "Task templates"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1task_templates~1{task_template_gid}~1instantiateTask/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet taskTemplatesApiInstance = new Asana.TaskTemplatesApi(client);\nlet task_template_gid = \"1331\"; // String | Globally unique identifier for the task template.\nlet opts = { \n    'body': {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}, \n    'opt_fields': \"dates_rollup_progress,dates_rollup_progress.total_tasks,dates_rollup_progress.updated_tasks,new_graph_export,new_graph_export.completed_at,new_graph_export.created_at,new_graph_export.download_url,new_portfolio,new_portfolio.name,new_portfolio.resource_subtype,new_project,new_project.name,new_project.resource_subtype,new_project_template,new_project_template.name,new_resource_export,new_resource_export.completed_at,new_resource_export.created_at,new_resource_export.download_url,new_task,new_task.created_by,new_task.name,new_task.resource_subtype,resource_subtype,status\"\n};\ntaskTemplatesApiInstance.instantiateTask(task_template_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasktemplates.instantiateTask(taskTemplateGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntask_templates_api_instance = asana.TaskTemplatesApi(api_client)\ntask_template_gid = \"1331\" # str | Globally unique identifier for the task template.\nopts = {\n    'body': {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}, # dict | Describes the inputs used for instantiating a task - the task's name.\n    'opt_fields': \"dates_rollup_progress,dates_rollup_progress.total_tasks,dates_rollup_progress.updated_tasks,new_graph_export,new_graph_export.completed_at,new_graph_export.created_at,new_graph_export.download_url,new_portfolio,new_portfolio.name,new_portfolio.resource_subtype,new_project,new_project.name,new_project.resource_subtype,new_project_template,new_project_template.name,new_resource_export,new_resource_export.completed_at,new_resource_export.created_at,new_resource_export.download_url,new_task,new_task.created_by,new_task.name,new_task.resource_subtype,resource_subtype,status\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Instantiate a task from a task template\n    api_response = task_templates_api_instance.instantiate_task(task_template_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TaskTemplatesApi->instantiate_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.task_templates.instantiate_task(task_template_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            }
          ]
        }
      }
    },
    "/tasks": {
      "get": {
        "description": "<b>Required scope: </b><code>tasks:read</code>\n\nReturns the compact task records for some filtered set of tasks. Use one or more of the parameters provided to filter the tasks returned. You must specify a `project` or `tag` if you do not specify `assignee` and `workspace`.\n\nFor more complex task retrieval, use [workspaces/{workspace_gid}/tasks/search](/reference/searchtasksforworkspace).",
        "operationId": "getTasks",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "The assignee to filter tasks on. If searching for unassigned tasks, assignee.any = null can be specified.\n*Note: If you specify `assignee`, you must also specify the `workspace` to filter on.*",
            "example": "14641",
            "in": "query",
            "name": "assignee",
            "schema": {
              "type": "string"
            },
            "x-env-variable": "assignee"
          },
          {
            "description": "The project to filter tasks on.",
            "example": "321654",
            "in": "query",
            "name": "project",
            "schema": {
              "type": "string"
            },
            "x-env-variable": "project"
          },
          {
            "description": "The section to filter tasks on.",
            "example": "321654",
            "in": "query",
            "name": "section",
            "schema": {
              "type": "string"
            },
            "x-env-variable": "section"
          },
          {
            "description": "The workspace to filter tasks on.\n*Note: If you specify `workspace`, you must also specify the `assignee` to filter on.*",
            "example": "321654",
            "in": "query",
            "name": "workspace",
            "schema": {
              "type": "string"
            },
            "x-env-variable": "workspace"
          },
          {
            "description": "Only return tasks that are either incomplete or that have been completed since this time.",
            "in": "query",
            "name": "completed_since",
            "schema": {
              "example": "2012-02-22T02:06:58.158Z",
              "format": "date-time",
              "type": "string"
            }
          },
          {
            "description": "Only return tasks that have been modified since the given time.\n\n*Note: A task is considered “modified” if any of its properties\nchange, or associations between it and other objects are modified\n(e.g.  a task being added to a project). A task is not considered\nmodified just because another object it is associated with (e.g. a\nsubtask) is modified. Actions that count as modifying the task\ninclude assigning, renaming, completing, and adding stories.*",
            "example": "2012-02-22T02:06:58.158Z",
            "in": "query",
            "name": "modified_since",
            "schema": {
              "format": "date-time",
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/custom_type_query_param"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "actual_time_minutes",
              "approval_status",
              "assigned_by",
              "assigned_by.name",
              "assignee",
              "assignee.name",
              "assignee_section",
              "assignee_section.name",
              "assignee_status",
              "completed",
              "completed_at",
              "completed_by",
              "completed_by.name",
              "created_at",
              "created_by",
              "custom_fields",
              "custom_fields.asana_created_field",
              "custom_fields.created_by",
              "custom_fields.created_by.name",
              "custom_fields.currency_code",
              "custom_fields.custom_label",
              "custom_fields.custom_label_position",
              "custom_fields.date_value",
              "custom_fields.date_value.date",
              "custom_fields.date_value.date_time",
              "custom_fields.default_access_level",
              "custom_fields.description",
              "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.format",
              "custom_fields.has_notifications_enabled",
              "custom_fields.html_text_value",
              "custom_fields.id_prefix",
              "custom_fields.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_global_to_workspace",
              "custom_fields.is_lookup_field",
              "custom_fields.is_value_read_only",
              "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.people_value",
              "custom_fields.people_value.name",
              "custom_fields.precision",
              "custom_fields.privacy_setting",
              "custom_fields.reference_value",
              "custom_fields.reference_value.name",
              "custom_fields.representation_type",
              "custom_fields.resource_subtype",
              "custom_fields.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "custom_type_status_option",
              "custom_type_status_option.name",
              "dependencies",
              "dependents",
              "due_at",
              "due_on",
              "effective_memberships",
              "external",
              "external.data",
              "followers",
              "followers.name",
              "has_subtasks_date_mismatch",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_notes",
              "is_rendered_as_separator",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "memberships",
              "memberships.project",
              "memberships.project.name",
              "memberships.project.resource_subtype",
              "memberships.section",
              "memberships.section.name",
              "modified_at",
              "name",
              "notes",
              "num_hearts",
              "num_likes",
              "num_subtasks",
              "offset",
              "parent",
              "parent.created_by",
              "parent.name",
              "parent.resource_subtype",
              "path",
              "permalink_url",
              "projects",
              "projects.name",
              "projects.resource_subtype",
              "resource_subtype",
              "start_at",
              "start_on",
              "tags",
              "tags.name",
              "uri",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "actual_time_minutes",
                  "approval_status",
                  "assigned_by",
                  "assigned_by.name",
                  "assignee",
                  "assignee.name",
                  "assignee_section",
                  "assignee_section.name",
                  "assignee_status",
                  "completed",
                  "completed_at",
                  "completed_by",
                  "completed_by.name",
                  "created_at",
                  "created_by",
                  "custom_fields",
                  "custom_fields.asana_created_field",
                  "custom_fields.created_by",
                  "custom_fields.created_by.name",
                  "custom_fields.currency_code",
                  "custom_fields.custom_label",
                  "custom_fields.custom_label_position",
                  "custom_fields.date_value",
                  "custom_fields.date_value.date",
                  "custom_fields.date_value.date_time",
                  "custom_fields.default_access_level",
                  "custom_fields.description",
                  "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.format",
                  "custom_fields.has_notifications_enabled",
                  "custom_fields.html_text_value",
                  "custom_fields.id_prefix",
                  "custom_fields.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_global_to_workspace",
                  "custom_fields.is_lookup_field",
                  "custom_fields.is_value_read_only",
                  "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.people_value",
                  "custom_fields.people_value.name",
                  "custom_fields.precision",
                  "custom_fields.privacy_setting",
                  "custom_fields.reference_value",
                  "custom_fields.reference_value.name",
                  "custom_fields.representation_type",
                  "custom_fields.resource_subtype",
                  "custom_fields.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "custom_type_status_option",
                  "custom_type_status_option.name",
                  "dependencies",
                  "dependents",
                  "due_at",
                  "due_on",
                  "effective_memberships",
                  "external",
                  "external.data",
                  "followers",
                  "followers.name",
                  "has_subtasks_date_mismatch",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_notes",
                  "is_rendered_as_separator",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "memberships",
                  "memberships.project",
                  "memberships.project.name",
                  "memberships.project.resource_subtype",
                  "memberships.section",
                  "memberships.section.name",
                  "modified_at",
                  "name",
                  "notes",
                  "num_hearts",
                  "num_likes",
                  "num_subtasks",
                  "offset",
                  "parent",
                  "parent.created_by",
                  "parent.name",
                  "parent.resource_subtype",
                  "path",
                  "permalink_url",
                  "projects",
                  "projects.name",
                  "projects.resource_subtype",
                  "resource_subtype",
                  "start_at",
                  "start_on",
                  "tags",
                  "tags.name",
                  "uri",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TaskCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TaskResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved requested tasks."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:read"
            ]
          }
        ],
        "summary": "Get multiple tasks",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Task> result = client.tasks.getTasks(modifiedSince, completedSince, workspace, section, project, assignee)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'assignee': \"14641\", \n    'project': \"321654\", \n    'section': \"321654\", \n    'workspace': \"321654\", \n    'completed_since': \"2012-02-22T02:06:58.158Z\", \n    'modified_since': \"2012-02-22T02:06:58.158Z\", \n    'custom_type': \"12345\", \n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,offset,parent,parent.created_by,parent.name,parent.resource_subtype,path,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,uri,workspace,workspace.name\"\n};\ntasksApiInstance.getTasks(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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.getTasks({param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(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    'assignee': \"14641\", # str | The assignee to filter tasks on. If searching for unassigned tasks, assignee.any = null can be specified. *Note: If you specify `assignee`, you must also specify the `workspace` to filter on.*\n    'project': \"321654\", # str | The project to filter tasks on.\n    'section': \"321654\", # str | The section to filter tasks on.\n    'workspace': \"321654\", # str | The workspace to filter tasks on. *Note: If you specify `workspace`, you must also specify the `assignee` to filter on.*\n    'completed_since': '2012-02-22T02:06:58.158Z', # datetime | Only return tasks that are either incomplete or that have been completed since this time.\n    'modified_since': '2012-02-22T02:06:58.158Z', # datetime | Only return tasks that have been modified since the given time.  *Note: A task is considered “modified” if any of its properties change, or associations between it and other objects are modified (e.g.  a task being added to a project). A task is not considered modified just because another object it is associated with (e.g. a subtask) is modified. Actions that count as modifying the task include assigning, renaming, completing, and adding stories.*\n    'custom_type': \"12345\", # str | Filter results by custom type. Provide a custom type GID to return only objects of that custom type (an unknown GID returns `400`). Provide an empty string to return only objects with no custom type assigned. If this parameter is omitted, results are not filtered by custom type.\n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,offset,parent,parent.created_by,parent.name,parent.resource_subtype,path,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,uri,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get multiple tasks\n    api_response = tasks_api_instance.get_tasks(opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->get_tasks: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.get_tasks({'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->getTasks(array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.get_tasks(param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>tasks:write</code>\n\nCreating a new task is as easy as POSTing to the `/tasks` endpoint with a\ndata block containing the fields you’d like to set on the task. Any\nunspecified fields will take on default values.\n\nEvery task is required to be created in a specific workspace, and this\nworkspace cannot be changed once set. The workspace need not be set\nexplicitly if you specify `projects` or a `parent` task instead.",
        "operationId": "createTask",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "actual_time_minutes",
              "approval_status",
              "assigned_by",
              "assigned_by.name",
              "assignee",
              "assignee.name",
              "assignee_section",
              "assignee_section.name",
              "assignee_status",
              "completed",
              "completed_at",
              "completed_by",
              "completed_by.name",
              "created_at",
              "created_by",
              "custom_fields",
              "custom_fields.asana_created_field",
              "custom_fields.created_by",
              "custom_fields.created_by.name",
              "custom_fields.currency_code",
              "custom_fields.custom_label",
              "custom_fields.custom_label_position",
              "custom_fields.date_value",
              "custom_fields.date_value.date",
              "custom_fields.date_value.date_time",
              "custom_fields.default_access_level",
              "custom_fields.description",
              "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.format",
              "custom_fields.has_notifications_enabled",
              "custom_fields.html_text_value",
              "custom_fields.id_prefix",
              "custom_fields.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_global_to_workspace",
              "custom_fields.is_lookup_field",
              "custom_fields.is_value_read_only",
              "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.people_value",
              "custom_fields.people_value.name",
              "custom_fields.precision",
              "custom_fields.privacy_setting",
              "custom_fields.reference_value",
              "custom_fields.reference_value.name",
              "custom_fields.representation_type",
              "custom_fields.resource_subtype",
              "custom_fields.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "custom_type_status_option",
              "custom_type_status_option.name",
              "dependencies",
              "dependents",
              "due_at",
              "due_on",
              "effective_memberships",
              "external",
              "external.data",
              "followers",
              "followers.name",
              "has_subtasks_date_mismatch",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_notes",
              "is_rendered_as_separator",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "memberships",
              "memberships.project",
              "memberships.project.name",
              "memberships.project.resource_subtype",
              "memberships.section",
              "memberships.section.name",
              "modified_at",
              "name",
              "notes",
              "num_hearts",
              "num_likes",
              "num_subtasks",
              "parent",
              "parent.created_by",
              "parent.name",
              "parent.resource_subtype",
              "permalink_url",
              "projects",
              "projects.name",
              "projects.resource_subtype",
              "resource_subtype",
              "start_at",
              "start_on",
              "tags",
              "tags.name",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "actual_time_minutes",
                  "approval_status",
                  "assigned_by",
                  "assigned_by.name",
                  "assignee",
                  "assignee.name",
                  "assignee_section",
                  "assignee_section.name",
                  "assignee_status",
                  "completed",
                  "completed_at",
                  "completed_by",
                  "completed_by.name",
                  "created_at",
                  "created_by",
                  "custom_fields",
                  "custom_fields.asana_created_field",
                  "custom_fields.created_by",
                  "custom_fields.created_by.name",
                  "custom_fields.currency_code",
                  "custom_fields.custom_label",
                  "custom_fields.custom_label_position",
                  "custom_fields.date_value",
                  "custom_fields.date_value.date",
                  "custom_fields.date_value.date_time",
                  "custom_fields.default_access_level",
                  "custom_fields.description",
                  "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.format",
                  "custom_fields.has_notifications_enabled",
                  "custom_fields.html_text_value",
                  "custom_fields.id_prefix",
                  "custom_fields.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_global_to_workspace",
                  "custom_fields.is_lookup_field",
                  "custom_fields.is_value_read_only",
                  "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.people_value",
                  "custom_fields.people_value.name",
                  "custom_fields.precision",
                  "custom_fields.privacy_setting",
                  "custom_fields.reference_value",
                  "custom_fields.reference_value.name",
                  "custom_fields.representation_type",
                  "custom_fields.resource_subtype",
                  "custom_fields.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "custom_type_status_option",
                  "custom_type_status_option.name",
                  "dependencies",
                  "dependents",
                  "due_at",
                  "due_on",
                  "effective_memberships",
                  "external",
                  "external.data",
                  "followers",
                  "followers.name",
                  "has_subtasks_date_mismatch",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_notes",
                  "is_rendered_as_separator",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "memberships",
                  "memberships.project",
                  "memberships.project.name",
                  "memberships.project.resource_subtype",
                  "memberships.section",
                  "memberships.section.name",
                  "modified_at",
                  "name",
                  "notes",
                  "num_hearts",
                  "num_likes",
                  "num_subtasks",
                  "parent",
                  "parent.created_by",
                  "parent.name",
                  "parent.resource_subtype",
                  "permalink_url",
                  "projects",
                  "projects.name",
                  "projects.resource_subtype",
                  "resource_subtype",
                  "start_at",
                  "start_on",
                  "tags",
                  "tags.name",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "allOf": [
                      {
                        "allOf": [
                          {
                            "allOf": [
                              {
                                "description": "The *task* is the basic object around which many operations in Asana are centered.",
                                "properties": {
                                  "created_by": {
                                    "description": "[Opt In](/docs/inputoutput-options). A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                                    "properties": {
                                      "gid": {
                                        "description": "Globally unique identifier of the resource.",
                                        "example": "1111",
                                        "type": "string"
                                      },
                                      "resource_type": {
                                        "description": "The type of resource.",
                                        "example": "user",
                                        "type": "string"
                                      }
                                    },
                                    "readOnly": true,
                                    "type": "object"
                                  },
                                  "gid": {
                                    "description": "Globally unique identifier of the resource, as a string.",
                                    "example": "12345",
                                    "readOnly": true,
                                    "type": "string",
                                    "x-insert-after": false
                                  },
                                  "name": {
                                    "description": "The name of the task.",
                                    "example": "Bug Task",
                                    "type": "string"
                                  },
                                  "resource_subtype": {
                                    "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe resource_subtype `milestone` represent a single moment in time. This means tasks with this subtype cannot have a start_date.",
                                    "enum": [
                                      "default_task",
                                      "milestone",
                                      "approval",
                                      "custom"
                                    ],
                                    "example": "default_task",
                                    "type": "string"
                                  },
                                  "resource_type": {
                                    "description": "The base type of this resource.",
                                    "example": "task",
                                    "readOnly": true,
                                    "type": "string",
                                    "x-insert-after": "gid"
                                  }
                                },
                                "type": "object"
                              },
                              {
                                "properties": {
                                  "actual_time_minutes": {
                                    "description": "<p><strong style={{ color: \"#4573D2\" }}>Full object requires scope: </strong><code>time_tracking_entries:read</code></p>\n\nThis value represents the sum of all the Time Tracking entries in the Actual Time field on a given Task. It is represented as a nullable long value.",
                                    "example": 200,
                                    "nullable": true,
                                    "readOnly": true,
                                    "type": "number"
                                  },
                                  "approval_status": {
                                    "description": "*Conditional* Reflects the approval status of this task. This field is kept in sync with `completed`, meaning `pending` translates to false while `approved`, `rejected`, and `changes_requested` translate to true. If you set completed to true, this field will be set to `approved`.",
                                    "enum": [
                                      "pending",
                                      "approved",
                                      "rejected",
                                      "changes_requested"
                                    ],
                                    "example": "pending",
                                    "type": "string"
                                  },
                                  "assigned_by": {
                                    "allOf": [
                                      {
                                        "$ref": "#/components/schemas/UserCompact"
                                      },
                                      {
                                        "description": "The user who assigned the task. This field is only returned when requesting it via opt_fields, and will be null if the task has no specific assigner (e.g., tasks created without an explicit assigner).",
                                        "readOnly": true
                                      }
                                    ],
                                    "nullable": true
                                  },
                                  "assignee_status": {
                                    "description": "*Deprecated* Scheduling status of this task for the user it is assigned to. This field can only be set if the assignee is non-null. Setting this field to \"inbox\" or \"upcoming\" inserts it at the top of the section, while the other options will insert at the bottom.",
                                    "enum": [
                                      "today",
                                      "upcoming",
                                      "later",
                                      "new",
                                      "inbox"
                                    ],
                                    "example": "upcoming",
                                    "type": "string"
                                  },
                                  "completed": {
                                    "description": "True if the task is currently marked complete, false if not.",
                                    "example": false,
                                    "type": "boolean"
                                  },
                                  "completed_at": {
                                    "description": "The time at which this task was completed, or null if the task is incomplete.",
                                    "example": "2012-02-22T02:06:58.147Z",
                                    "format": "date-time",
                                    "nullable": true,
                                    "readOnly": true,
                                    "type": "string"
                                  },
                                  "completed_by": {
                                    "allOf": [
                                      {
                                        "$ref": "#/components/schemas/UserCompact"
                                      },
                                      {
                                        "readOnly": true
                                      }
                                    ],
                                    "nullable": true
                                  },
                                  "created_at": {
                                    "description": "The time at which this resource was created.",
                                    "example": "2012-02-22T02:06:58.147Z",
                                    "format": "date-time",
                                    "readOnly": true,
                                    "type": "string"
                                  },
                                  "dependencies": {
                                    "description": "[Opt In](/docs/inputoutput-options). Array of resources referencing tasks that this task depends on. The objects contain only the gid of the dependency.",
                                    "items": {
                                      "$ref": "#/components/schemas/AsanaResource"
                                    },
                                    "readOnly": true,
                                    "type": "array"
                                  },
                                  "dependents": {
                                    "description": "[Opt In](/docs/inputoutput-options). Array of resources referencing tasks that depend on this task. The objects contain only the ID of the dependent.",
                                    "items": {
                                      "$ref": "#/components/schemas/AsanaResource"
                                    },
                                    "readOnly": true,
                                    "type": "array"
                                  },
                                  "due_at": {
                                    "description": "The UTC date and time on which this task is due, or null if the task has no due time. This takes an ISO 8601 date string in UTC and should not be used together with `due_on`.",
                                    "example": "2019-09-15T02:06:58.147Z",
                                    "format": "date-time",
                                    "nullable": true,
                                    "type": "string"
                                  },
                                  "due_on": {
                                    "description": "The localized date on which this task is due, or null if the task has no due date. This takes a date with `YYYY-MM-DD` format and should not be used together with `due_at`.",
                                    "example": "2019-09-15",
                                    "format": "date",
                                    "nullable": true,
                                    "type": "string"
                                  },
                                  "external": {
                                    "description": "*OAuth Required*. *Conditional*. This field is returned only if external values are set or included by using [Opt In](/docs/inputoutput-options).\nThe external field allows you to store app-specific metadata on tasks, including a gid that can be used to retrieve tasks and a data blob that can store app-specific character strings. Note that you will need to authenticate with Oauth to access or modify this data. Once an external gid is set, you can use the notation `external:custom_gid` to reference your object anywhere in the API where you may use the original object gid. See the page on Custom External Data for more details.",
                                    "example": {
                                      "data": "A blob of information",
                                      "gid": "my_gid"
                                    },
                                    "properties": {
                                      "data": {
                                        "example": "A blob of information.",
                                        "type": "string"
                                      },
                                      "gid": {
                                        "example": "1234",
                                        "type": "string"
                                      }
                                    },
                                    "type": "object"
                                  },
                                  "has_subtasks_date_mismatch": {
                                    "description": "[Opt In](/docs/inputoutput-options). True when one or more descendant subtasks have dates outside the task's own date range. This field reflects the latest computed rollup state and returns false when no rollup has been computed.",
                                    "example": true,
                                    "readOnly": true,
                                    "type": "boolean"
                                  },
                                  "hearted": {
                                    "description": "*Deprecated - please use liked instead* True if the task is hearted by the authorized user, false if not.",
                                    "example": true,
                                    "readOnly": true,
                                    "type": "boolean"
                                  },
                                  "hearts": {
                                    "description": "*Deprecated - please use likes instead* Array of likes for users who have hearted this task.",
                                    "items": {
                                      "$ref": "#/components/schemas/Like"
                                    },
                                    "readOnly": true,
                                    "type": "array"
                                  },
                                  "html_notes": {
                                    "description": "[Opt In](/docs/inputoutput-options). The notes of the text with formatting as HTML. See [rich text](/docs/rich-text).",
                                    "example": "<body>Mittens <em>really</em> likes the stuff from Humboldt.</body>",
                                    "type": "string"
                                  },
                                  "is_rendered_as_separator": {
                                    "description": "[Opt In](/docs/inputoutput-options). In some contexts tasks can be rendered as a visual separator; for instance, subtasks can appear similar to [sections](/reference/sections) without being true `section` objects. If a `task` object is rendered this way in any context it will have the property `is_rendered_as_separator` set to `true`. This parameter only applies to regular tasks with `resource_subtype` of `default_task`. Tasks with `resource_subtype` of `milestone`, `approval`, or custom task types will not have this property and cannot be rendered as separators.",
                                    "example": false,
                                    "readOnly": true,
                                    "type": "boolean"
                                  },
                                  "liked": {
                                    "description": "True if the task is liked by the authorized user, false if not.",
                                    "example": true,
                                    "type": "boolean"
                                  },
                                  "likes": {
                                    "description": "Array of likes for users who have liked this task.",
                                    "items": {
                                      "$ref": "#/components/schemas/Like"
                                    },
                                    "readOnly": true,
                                    "type": "array"
                                  },
                                  "memberships": {
                                    "description": "Create-only project and section membership IDs.",
                                    "items": {
                                      "properties": {
                                        "project": {
                                          "type": "string"
                                        },
                                        "section": {
                                          "nullable": true,
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "project"
                                      ],
                                      "type": "object"
                                    },
                                    "type": "array"
                                  },
                                  "modified_at": {
                                    "description": "The time at which this task was last modified.\n\nThe following conditions will change `modified_at`:\n\n- story is created on a task\n- story is trashed on a task\n- attachment is trashed on a task\n- task is assigned or unassigned\n- custom field value is changed\n- the task itself is trashed\n- Or if any of the following fields are updated:\n  - completed\n  - name\n  - due_date\n  - description\n  - attachments\n  - items\n  - schedule_status\n\nThe following conditions will _not_ change `modified_at`:\n\n- moving to a new container (project, portfolio, etc)\n- comments being added to the task (but the stories they generate\n  _will_ affect `modified_at`)",
                                    "example": "2012-02-22T02:06:58.147Z",
                                    "format": "date-time",
                                    "readOnly": true,
                                    "type": "string"
                                  },
                                  "name": {
                                    "description": "Name of the task. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.",
                                    "example": "Buy catnip",
                                    "type": "string"
                                  },
                                  "notes": {
                                    "description": "Free-form textual information associated with the task (i.e. its description).",
                                    "example": "Mittens really likes the stuff from Humboldt.",
                                    "type": "string"
                                  },
                                  "num_hearts": {
                                    "description": "*Deprecated - please use likes instead* The number of users who have hearted this task.",
                                    "example": 5,
                                    "readOnly": true,
                                    "type": "integer"
                                  },
                                  "num_likes": {
                                    "description": "The number of users who have liked this task.",
                                    "example": 5,
                                    "readOnly": true,
                                    "type": "integer"
                                  },
                                  "num_subtasks": {
                                    "description": "[Opt In](/docs/inputoutput-options). The number of subtasks on this task.\n",
                                    "example": 3,
                                    "readOnly": true,
                                    "type": "integer"
                                  },
                                  "start_at": {
                                    "description": "Date and time on which work begins for the task, or null if the task has no start time. This takes an ISO 8601 date string in UTC and should not be used together with `start_on`.\n*Note: `due_at` must be present in the request when setting or unsetting the `start_at` parameter.*",
                                    "example": "2019-09-14T02:06:58.147Z",
                                    "format": "date-time",
                                    "nullable": true,
                                    "type": "string"
                                  },
                                  "start_on": {
                                    "description": "The day on which work begins for the task , or null if the task has no start date. This takes a date with `YYYY-MM-DD` format and should not be used together with `start_at`.\n*Note: `due_on` or `due_at` must be present in the request when setting or unsetting the `start_on` parameter.*",
                                    "example": "2019-09-14",
                                    "format": "date",
                                    "nullable": true,
                                    "type": "string"
                                  }
                                },
                                "type": "object"
                              }
                            ]
                          },
                          {
                            "properties": {
                              "assignee": {
                                "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
                                "example": "12345",
                                "nullable": true,
                                "readOnly": false,
                                "type": "string",
                                "x-env-variable": true
                              },
                              "assignee_section": {
                                "description": "The *assignee section* is a subdivision of a project that groups tasks together in the assignee's \"My tasks\" list. It can either be a header above a list of tasks in a list view or a column in a board view of \"My tasks.\"\nThe `assignee_section` property will be returned in the response only if the request was sent by the user who is the assignee of the task. Note that you can only write to `assignee_section` with the gid of an existing section visible in the user's \"My tasks\" list.",
                                "example": "12345",
                                "nullable": true,
                                "type": "string"
                              },
                              "custom_fields": {
                                "additionalProperties": {
                                  "description": "\"{custom_field_gid}\" => Value (can be text, a number, etc.). For date, use format \"YYYY-MM-DD\" (e.g., 2019-09-15). For date-time, use ISO 8601 date string in UTC (e.g., 2019-09-15T02:06:58.147Z).",
                                  "type": "string"
                                },
                                "description": "An object where each key is the GID of a custom field and its corresponding value is either an enum GID, string, number, object, or array (depending on the custom field type). See the [custom fields guide](/docs/custom-fields-guide) for details on creating and updating custom field values.",
                                "example": {
                                  "4578152156": "Not Started",
                                  "5678904321": "On Hold"
                                },
                                "type": "object"
                              },
                              "custom_type": {
                                "description": "*Conditional:* You can only set custom_type if task `resource_subtype` is `custom`. GID or globally-unique identifier of a task's custom type. The type must be valid for tasks, and some Asana-created custom types cannot be assigned via the API; attempting either returns an error explaining which condition failed.",
                                "example": "12345",
                                "nullable": true,
                                "readOnly": false,
                                "type": "string",
                                "x-env-variable": true
                              },
                              "custom_type_status_option": {
                                "description": "*Conditional:* You can only set custom_type_status_option if task `resource_subtype` is `custom` GID or globally-unique identifier of a custom type's status option.",
                                "example": "12345",
                                "nullable": true,
                                "readOnly": false,
                                "type": "string",
                                "x-env-variable": true
                              },
                              "html_custom_fields": {
                                "additionalProperties": {
                                  "description": "\"{custom_field_gid}\" => HTML string (e.g., \"<body>Text content</body>\")",
                                  "type": "string"
                                },
                                "description": "An object where each key is the GID of a text custom field and the corresponding value is a rich text HTML string. Only text-type custom fields support this parameter. Values must be wrapped in <body></body> tags. See the [custom fields guide](/docs/custom-fields-guide) and [rich text](/docs/rich-text) for details on supported formatting.",
                                "example": {
                                  "4578152156": "<body><code>Code block</code></body>",
                                  "5678904321": "<body><strong>Bold text</strong></body>"
                                },
                                "type": "object"
                              },
                              "parent": {
                                "description": "Gid of a task.",
                                "example": "12345",
                                "nullable": true,
                                "readOnly": false,
                                "type": "string",
                                "x-env-variable": true
                              }
                            },
                            "type": "object"
                          }
                        ]
                      },
                      {
                        "properties": {
                          "followers": {
                            "description": "*Create-Only* An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user. In order to change followers on an existing task use `addFollowers` and `removeFollowers`.",
                            "example": [
                              "12345"
                            ],
                            "items": {
                              "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
                              "type": "string"
                            },
                            "type": "array"
                          },
                          "projects": {
                            "description": "*Create-Only* Array of project gids. In order to change projects on an existing task use `addProject` and `removeProject`.",
                            "example": [
                              "12345"
                            ],
                            "items": {
                              "description": "Gid of a project.",
                              "type": "string"
                            },
                            "type": "array"
                          },
                          "tags": {
                            "description": "*Create-Only* Array of tag gids. In order to change tags on an existing task use `addTag` and `removeTag`.",
                            "example": [
                              "12345"
                            ],
                            "items": {
                              "description": "Gid of a tag.",
                              "type": "string"
                            },
                            "type": "array"
                          },
                          "workspace": {
                            "description": "Gid of a workspace.",
                            "example": "12345",
                            "readOnly": false,
                            "type": "string",
                            "x-env-variable": true
                          }
                        },
                        "type": "object"
                      }
                    ]
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The task to create.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TaskResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TaskResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created a new task."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:write"
            ]
          }
        ],
        "summary": "Create a task",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nTask result = client.tasks.createTask()\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The task to create.\nlet opts = { \n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,parent,parent.created_by,parent.name,parent.resource_subtype,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,workspace,workspace.name\"\n};\ntasksApiInstance.createTask(body, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.createTask({field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The task to create.\nopts = {\n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,parent,parent.created_by,parent.name,parent.resource_subtype,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create a task\n    api_response = tasks_api_instance.create_task(body, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->create_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.create_task({'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->createTask(array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.create_task(field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/tasks/{task_gid}": {
      "delete": {
        "description": "<b>Required scope: </b><code>tasks:delete</code>\n\nA specific, existing task can be deleted by making a DELETE request on\nthe URL for that task. Deleted tasks go into the “trash” of the user\nmaking the delete request. Tasks can be recovered from the trash within a\nperiod of 30 days; afterward they are completely removed from the system.\n\nReturns an empty data record.",
        "operationId": "deleteTask",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully deleted the specified task."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:delete"
            ]
          }
        ],
        "summary": "Delete a task",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.tasks.deleteTask(taskGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet task_gid = \"321654\"; // String | The task to operate on.\n\ntasksApiInstance.deleteTask(task_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.deleteTask(taskGid)\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\ntask_gid = \"321654\" # str | The task to operate on.\n\n\ntry:\n    # Delete a task\n    api_response = tasks_api_instance.delete_task(task_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->delete_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.delete_task(task_gid, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->deleteTask($task_gid, array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.delete_task(task_gid: 'task_gid', options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "get": {
        "description": "<b>Required scope: </b><code>tasks:read</code>\n\n<table>\n  <tr>\n    <th>Field</th>\n    <th>Required Scope</th>\n  </tr>\n  <tr>\n    <td><code>memberships</code></td>\n    <td><code>projects:read</code>, <code>project_sections:read</code></td>\n  </tr>\n  <tr>\n    <td><code>effective_memberships</code></td>\n    <td><code>projects:read</code>, <code>project_sections:read</code></td>\n  </tr>\n  <tr>\n    <td><code>custom_type</code></td>\n    <td><code>custom_types:read</code></td>\n  </tr>\n  <tr>\n    <td><code>custom_type_status_option</code></td>\n    <td><code>custom_types:read</code></td>\n  </tr>\n  <tr>\n    <td><code>actual_time_minutes</code></td>\n    <td><code>time_tracking_entries:read</code></td>\n  </tr>\n</table>\n\nReturns the complete task record for a single task.",
        "operationId": "getTask",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "actual_time_minutes",
              "approval_status",
              "assigned_by",
              "assigned_by.name",
              "assignee",
              "assignee.name",
              "assignee_section",
              "assignee_section.name",
              "assignee_status",
              "completed",
              "completed_at",
              "completed_by",
              "completed_by.name",
              "created_at",
              "created_by",
              "custom_fields",
              "custom_fields.asana_created_field",
              "custom_fields.created_by",
              "custom_fields.created_by.name",
              "custom_fields.currency_code",
              "custom_fields.custom_label",
              "custom_fields.custom_label_position",
              "custom_fields.date_value",
              "custom_fields.date_value.date",
              "custom_fields.date_value.date_time",
              "custom_fields.default_access_level",
              "custom_fields.description",
              "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.format",
              "custom_fields.has_notifications_enabled",
              "custom_fields.html_text_value",
              "custom_fields.id_prefix",
              "custom_fields.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_global_to_workspace",
              "custom_fields.is_lookup_field",
              "custom_fields.is_value_read_only",
              "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.people_value",
              "custom_fields.people_value.name",
              "custom_fields.precision",
              "custom_fields.privacy_setting",
              "custom_fields.reference_value",
              "custom_fields.reference_value.name",
              "custom_fields.representation_type",
              "custom_fields.resource_subtype",
              "custom_fields.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "custom_type_status_option",
              "custom_type_status_option.name",
              "dependencies",
              "dependents",
              "due_at",
              "due_on",
              "effective_memberships",
              "external",
              "external.data",
              "followers",
              "followers.name",
              "has_subtasks_date_mismatch",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_notes",
              "is_rendered_as_separator",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "memberships",
              "memberships.project",
              "memberships.project.name",
              "memberships.project.resource_subtype",
              "memberships.section",
              "memberships.section.name",
              "modified_at",
              "name",
              "notes",
              "num_hearts",
              "num_likes",
              "num_subtasks",
              "parent",
              "parent.created_by",
              "parent.name",
              "parent.resource_subtype",
              "permalink_url",
              "projects",
              "projects.name",
              "projects.resource_subtype",
              "resource_subtype",
              "start_at",
              "start_on",
              "tags",
              "tags.name",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "actual_time_minutes",
                  "approval_status",
                  "assigned_by",
                  "assigned_by.name",
                  "assignee",
                  "assignee.name",
                  "assignee_section",
                  "assignee_section.name",
                  "assignee_status",
                  "completed",
                  "completed_at",
                  "completed_by",
                  "completed_by.name",
                  "created_at",
                  "created_by",
                  "custom_fields",
                  "custom_fields.asana_created_field",
                  "custom_fields.created_by",
                  "custom_fields.created_by.name",
                  "custom_fields.currency_code",
                  "custom_fields.custom_label",
                  "custom_fields.custom_label_position",
                  "custom_fields.date_value",
                  "custom_fields.date_value.date",
                  "custom_fields.date_value.date_time",
                  "custom_fields.default_access_level",
                  "custom_fields.description",
                  "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.format",
                  "custom_fields.has_notifications_enabled",
                  "custom_fields.html_text_value",
                  "custom_fields.id_prefix",
                  "custom_fields.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_global_to_workspace",
                  "custom_fields.is_lookup_field",
                  "custom_fields.is_value_read_only",
                  "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.people_value",
                  "custom_fields.people_value.name",
                  "custom_fields.precision",
                  "custom_fields.privacy_setting",
                  "custom_fields.reference_value",
                  "custom_fields.reference_value.name",
                  "custom_fields.representation_type",
                  "custom_fields.resource_subtype",
                  "custom_fields.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "custom_type_status_option",
                  "custom_type_status_option.name",
                  "dependencies",
                  "dependents",
                  "due_at",
                  "due_on",
                  "effective_memberships",
                  "external",
                  "external.data",
                  "followers",
                  "followers.name",
                  "has_subtasks_date_mismatch",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_notes",
                  "is_rendered_as_separator",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "memberships",
                  "memberships.project",
                  "memberships.project.name",
                  "memberships.project.resource_subtype",
                  "memberships.section",
                  "memberships.section.name",
                  "modified_at",
                  "name",
                  "notes",
                  "num_hearts",
                  "num_likes",
                  "num_subtasks",
                  "parent",
                  "parent.created_by",
                  "parent.name",
                  "parent.resource_subtype",
                  "permalink_url",
                  "projects",
                  "projects.name",
                  "projects.resource_subtype",
                  "resource_subtype",
                  "start_at",
                  "start_on",
                  "tags",
                  "tags.name",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TaskResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TaskResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the specified task."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:read"
            ]
          }
        ],
        "summary": "Get a task",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nTask result = client.tasks.getTask(taskGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet task_gid = \"321654\"; // String | The task to operate on.\nlet opts = { \n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,parent,parent.created_by,parent.name,parent.resource_subtype,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,workspace,workspace.name\"\n};\ntasksApiInstance.getTask(task_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.getTask(taskGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\ntask_gid = \"321654\" # str | The task to operate on.\nopts = {\n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,parent,parent.created_by,parent.name,parent.resource_subtype,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a task\n    api_response = tasks_api_instance.get_task(task_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->get_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.get_task(task_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->getTask($task_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.get_task(task_gid: 'task_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/task_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "put": {
        "description": "<b>Required scope: </b><code>tasks:write</code>\n\nA specific, existing task can be updated by making a PUT request on the\nURL for that task. Only the fields provided in the `data` block will be\nupdated; any unspecified fields will remain unchanged.\n\nWhen using this method, it is best to specify only those fields you wish\nto change, or else you may overwrite changes made by another user since\nyou last retrieved the task.\n\nReturns the complete updated task record.",
        "operationId": "updateTask",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "actual_time_minutes",
              "approval_status",
              "assigned_by",
              "assigned_by.name",
              "assignee",
              "assignee.name",
              "assignee_section",
              "assignee_section.name",
              "assignee_status",
              "completed",
              "completed_at",
              "completed_by",
              "completed_by.name",
              "created_at",
              "created_by",
              "custom_fields",
              "custom_fields.asana_created_field",
              "custom_fields.created_by",
              "custom_fields.created_by.name",
              "custom_fields.currency_code",
              "custom_fields.custom_label",
              "custom_fields.custom_label_position",
              "custom_fields.date_value",
              "custom_fields.date_value.date",
              "custom_fields.date_value.date_time",
              "custom_fields.default_access_level",
              "custom_fields.description",
              "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.format",
              "custom_fields.has_notifications_enabled",
              "custom_fields.html_text_value",
              "custom_fields.id_prefix",
              "custom_fields.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_global_to_workspace",
              "custom_fields.is_lookup_field",
              "custom_fields.is_value_read_only",
              "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.people_value",
              "custom_fields.people_value.name",
              "custom_fields.precision",
              "custom_fields.privacy_setting",
              "custom_fields.reference_value",
              "custom_fields.reference_value.name",
              "custom_fields.representation_type",
              "custom_fields.resource_subtype",
              "custom_fields.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "custom_type_status_option",
              "custom_type_status_option.name",
              "dependencies",
              "dependents",
              "due_at",
              "due_on",
              "effective_memberships",
              "external",
              "external.data",
              "followers",
              "followers.name",
              "has_subtasks_date_mismatch",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_notes",
              "is_rendered_as_separator",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "memberships",
              "memberships.project",
              "memberships.project.name",
              "memberships.project.resource_subtype",
              "memberships.section",
              "memberships.section.name",
              "modified_at",
              "name",
              "notes",
              "num_hearts",
              "num_likes",
              "num_subtasks",
              "parent",
              "parent.created_by",
              "parent.name",
              "parent.resource_subtype",
              "permalink_url",
              "projects",
              "projects.name",
              "projects.resource_subtype",
              "resource_subtype",
              "start_at",
              "start_on",
              "tags",
              "tags.name",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "actual_time_minutes",
                  "approval_status",
                  "assigned_by",
                  "assigned_by.name",
                  "assignee",
                  "assignee.name",
                  "assignee_section",
                  "assignee_section.name",
                  "assignee_status",
                  "completed",
                  "completed_at",
                  "completed_by",
                  "completed_by.name",
                  "created_at",
                  "created_by",
                  "custom_fields",
                  "custom_fields.asana_created_field",
                  "custom_fields.created_by",
                  "custom_fields.created_by.name",
                  "custom_fields.currency_code",
                  "custom_fields.custom_label",
                  "custom_fields.custom_label_position",
                  "custom_fields.date_value",
                  "custom_fields.date_value.date",
                  "custom_fields.date_value.date_time",
                  "custom_fields.default_access_level",
                  "custom_fields.description",
                  "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.format",
                  "custom_fields.has_notifications_enabled",
                  "custom_fields.html_text_value",
                  "custom_fields.id_prefix",
                  "custom_fields.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_global_to_workspace",
                  "custom_fields.is_lookup_field",
                  "custom_fields.is_value_read_only",
                  "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.people_value",
                  "custom_fields.people_value.name",
                  "custom_fields.precision",
                  "custom_fields.privacy_setting",
                  "custom_fields.reference_value",
                  "custom_fields.reference_value.name",
                  "custom_fields.representation_type",
                  "custom_fields.resource_subtype",
                  "custom_fields.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "custom_type_status_option",
                  "custom_type_status_option.name",
                  "dependencies",
                  "dependents",
                  "due_at",
                  "due_on",
                  "effective_memberships",
                  "external",
                  "external.data",
                  "followers",
                  "followers.name",
                  "has_subtasks_date_mismatch",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_notes",
                  "is_rendered_as_separator",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "memberships",
                  "memberships.project",
                  "memberships.project.name",
                  "memberships.project.resource_subtype",
                  "memberships.section",
                  "memberships.section.name",
                  "modified_at",
                  "name",
                  "notes",
                  "num_hearts",
                  "num_likes",
                  "num_subtasks",
                  "parent",
                  "parent.created_by",
                  "parent.name",
                  "parent.resource_subtype",
                  "permalink_url",
                  "projects",
                  "projects.name",
                  "projects.resource_subtype",
                  "resource_subtype",
                  "start_at",
                  "start_on",
                  "tags",
                  "tags.name",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TaskUpdateRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The task to update.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TaskResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TaskResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully updated the specified task."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:write"
            ]
          }
        ],
        "summary": "Update a task",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}/put",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nTask result = client.tasks.updateTask(taskGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The task to update.\nlet task_gid = \"321654\"; // String | The task to operate on.\nlet opts = { \n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,parent,parent.created_by,parent.name,parent.resource_subtype,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,workspace,workspace.name\"\n};\ntasksApiInstance.updateTask(body, task_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.updateTask(taskGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The task to update.\ntask_gid = \"321654\" # str | The task to operate on.\nopts = {\n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,parent,parent.created_by,parent.name,parent.resource_subtype,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Update a task\n    api_response = tasks_api_instance.update_task(body, task_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->update_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.update_task(task_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->updateTask($task_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.update_task(task_gid: 'task_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/tasks/{task_gid}/addDependencies": {
      "parameters": [
        {
          "$ref": "#/components/parameters/task_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>tasks:write</code>\n\nMarks a set of tasks as dependencies of this task, if they are not already dependencies. *A task can have at most 30 dependents and dependencies combined*.",
        "operationId": "addDependenciesForTask",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/ModifyDependenciesRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The list of tasks to set as dependencies.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully set the specified dependencies on the task."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:write"
            ]
          }
        ],
        "summary": "Set dependencies for a task",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}~1addDependencies/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.tasks.addDependenciesForTask(taskGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The list of tasks to set as dependencies.\nlet task_gid = \"321654\"; // String | The task to operate on.\n\ntasksApiInstance.addDependenciesForTask(body, task_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.addDependenciesForTask(taskGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The list of tasks to set as dependencies.\ntask_gid = \"321654\" # str | The task to operate on.\n\n\ntry:\n    # Set dependencies for a task\n    api_response = tasks_api_instance.add_dependencies_for_task(body, task_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->add_dependencies_for_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.add_dependencies_for_task(task_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->addDependenciesForTask($task_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.add_dependencies_for_task(task_gid: 'task_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/tasks/{task_gid}/addDependents": {
      "parameters": [
        {
          "$ref": "#/components/parameters/task_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>tasks:write</code>\n\nMarks a set of tasks as dependents of this task, if they are not already dependents. *A task can have at most 30 dependents and dependencies combined*.",
        "operationId": "addDependentsForTask",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/ModifyDependentsRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The list of tasks to add as dependents.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully set the specified dependents on the given task."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:write"
            ]
          }
        ],
        "summary": "Set dependents for a task",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}~1addDependents/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.tasks.addDependentsForTask(taskGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The list of tasks to add as dependents.\nlet task_gid = \"321654\"; // String | The task to operate on.\n\ntasksApiInstance.addDependentsForTask(body, task_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.addDependentsForTask(taskGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The list of tasks to add as dependents.\ntask_gid = \"321654\" # str | The task to operate on.\n\n\ntry:\n    # Set dependents for a task\n    api_response = tasks_api_instance.add_dependents_for_task(body, task_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->add_dependents_for_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.add_dependents_for_task(task_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->addDependentsForTask($task_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.add_dependents_for_task(task_gid: 'task_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/tasks/{task_gid}/addFollowers": {
      "parameters": [
        {
          "$ref": "#/components/parameters/task_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>tasks:write</code>\n\nAdds followers to a task. Returns an empty data block.\nEach task can be associated with zero or more followers in the system.\nRequests to add/remove followers, if successful, will return the complete updated task record, described above.",
        "operationId": "addFollowersForTask",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "actual_time_minutes",
              "approval_status",
              "assigned_by",
              "assigned_by.name",
              "assignee",
              "assignee.name",
              "assignee_section",
              "assignee_section.name",
              "assignee_status",
              "completed",
              "completed_at",
              "completed_by",
              "completed_by.name",
              "created_at",
              "created_by",
              "custom_fields",
              "custom_fields.asana_created_field",
              "custom_fields.created_by",
              "custom_fields.created_by.name",
              "custom_fields.currency_code",
              "custom_fields.custom_label",
              "custom_fields.custom_label_position",
              "custom_fields.date_value",
              "custom_fields.date_value.date",
              "custom_fields.date_value.date_time",
              "custom_fields.default_access_level",
              "custom_fields.description",
              "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.format",
              "custom_fields.has_notifications_enabled",
              "custom_fields.html_text_value",
              "custom_fields.id_prefix",
              "custom_fields.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_global_to_workspace",
              "custom_fields.is_lookup_field",
              "custom_fields.is_value_read_only",
              "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.people_value",
              "custom_fields.people_value.name",
              "custom_fields.precision",
              "custom_fields.privacy_setting",
              "custom_fields.reference_value",
              "custom_fields.reference_value.name",
              "custom_fields.representation_type",
              "custom_fields.resource_subtype",
              "custom_fields.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "custom_type_status_option",
              "custom_type_status_option.name",
              "dependencies",
              "dependents",
              "due_at",
              "due_on",
              "effective_memberships",
              "external",
              "external.data",
              "followers",
              "followers.name",
              "has_subtasks_date_mismatch",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_notes",
              "is_rendered_as_separator",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "memberships",
              "memberships.project",
              "memberships.project.name",
              "memberships.project.resource_subtype",
              "memberships.section",
              "memberships.section.name",
              "modified_at",
              "name",
              "notes",
              "num_hearts",
              "num_likes",
              "num_subtasks",
              "parent",
              "parent.created_by",
              "parent.name",
              "parent.resource_subtype",
              "permalink_url",
              "projects",
              "projects.name",
              "projects.resource_subtype",
              "resource_subtype",
              "start_at",
              "start_on",
              "tags",
              "tags.name",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "actual_time_minutes",
                  "approval_status",
                  "assigned_by",
                  "assigned_by.name",
                  "assignee",
                  "assignee.name",
                  "assignee_section",
                  "assignee_section.name",
                  "assignee_status",
                  "completed",
                  "completed_at",
                  "completed_by",
                  "completed_by.name",
                  "created_at",
                  "created_by",
                  "custom_fields",
                  "custom_fields.asana_created_field",
                  "custom_fields.created_by",
                  "custom_fields.created_by.name",
                  "custom_fields.currency_code",
                  "custom_fields.custom_label",
                  "custom_fields.custom_label_position",
                  "custom_fields.date_value",
                  "custom_fields.date_value.date",
                  "custom_fields.date_value.date_time",
                  "custom_fields.default_access_level",
                  "custom_fields.description",
                  "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.format",
                  "custom_fields.has_notifications_enabled",
                  "custom_fields.html_text_value",
                  "custom_fields.id_prefix",
                  "custom_fields.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_global_to_workspace",
                  "custom_fields.is_lookup_field",
                  "custom_fields.is_value_read_only",
                  "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.people_value",
                  "custom_fields.people_value.name",
                  "custom_fields.precision",
                  "custom_fields.privacy_setting",
                  "custom_fields.reference_value",
                  "custom_fields.reference_value.name",
                  "custom_fields.representation_type",
                  "custom_fields.resource_subtype",
                  "custom_fields.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "custom_type_status_option",
                  "custom_type_status_option.name",
                  "dependencies",
                  "dependents",
                  "due_at",
                  "due_on",
                  "effective_memberships",
                  "external",
                  "external.data",
                  "followers",
                  "followers.name",
                  "has_subtasks_date_mismatch",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_notes",
                  "is_rendered_as_separator",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "memberships",
                  "memberships.project",
                  "memberships.project.name",
                  "memberships.project.resource_subtype",
                  "memberships.section",
                  "memberships.section.name",
                  "modified_at",
                  "name",
                  "notes",
                  "num_hearts",
                  "num_likes",
                  "num_subtasks",
                  "parent",
                  "parent.created_by",
                  "parent.name",
                  "parent.resource_subtype",
                  "permalink_url",
                  "projects",
                  "projects.name",
                  "projects.resource_subtype",
                  "resource_subtype",
                  "start_at",
                  "start_on",
                  "tags",
                  "tags.name",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TaskAddFollowersRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The followers to add to the task.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TaskResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TaskResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully added the specified followers to the task."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:write"
            ]
          }
        ],
        "summary": "Add followers to a task",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}~1addFollowers/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nTask result = client.tasks.addFollowersForTask(taskGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The followers to add to the task.\nlet task_gid = \"321654\"; // String | The task to operate on.\nlet opts = { \n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,parent,parent.created_by,parent.name,parent.resource_subtype,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,workspace,workspace.name\"\n};\ntasksApiInstance.addFollowersForTask(body, task_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.addFollowersForTask(taskGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The followers to add to the task.\ntask_gid = \"321654\" # str | The task to operate on.\nopts = {\n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,parent,parent.created_by,parent.name,parent.resource_subtype,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Add followers to a task\n    api_response = tasks_api_instance.add_followers_for_task(body, task_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->add_followers_for_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.add_followers_for_task(task_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->addFollowersForTask($task_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.add_followers_for_task(task_gid: 'task_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/tasks/{task_gid}/addProject": {
      "parameters": [
        {
          "$ref": "#/components/parameters/task_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>tasks:write</code>\n\nAdds the task to the specified project, in the optional location\nspecified. If no location arguments are given, the task will be added to\nthe end of the project.\n\n`addProject` can also be used to reorder a task within a project or\nsection that already contains it.\n\n**Positioning the task:**\n- Use `insert_before` or `insert_after` with a task ID to position relative to another task\n- Use `section` alone to add the task to the end of a section\n- Use `section` with `insert_after: null` to add to the **beginning** of a section\n- Use `section` with `insert_before: null` to add to the **end** of a section\n- Use `section` with `insert_before` or `insert_after` (non-null) to position relative to a task within that section. The anchor task must be in the specified section.\n\nAt most one of `insert_before` or `insert_after` should be specified (both cannot be used together).\n\nA task can have at most 20 projects multi-homed to it.\n\nReturns an empty data block.",
        "operationId": "addProjectForTask",
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "addAfterTaskInSection": {
                  "summary": "Add task after another task in a section",
                  "value": {
                    "data": {
                      "insert_after": "124816",
                      "project": "13579",
                      "section": "987654"
                    }
                  }
                },
                "addBeforeTaskInSection": {
                  "summary": "Add task before another task in a section",
                  "value": {
                    "data": {
                      "insert_before": "432134",
                      "project": "13579",
                      "section": "987654"
                    }
                  }
                },
                "addToBeginningOfSection": {
                  "summary": "Add task to beginning of a section",
                  "value": {
                    "data": {
                      "project": "13579",
                      "section": "987654"
                    }
                  }
                },
                "addToEndOfSection": {
                  "summary": "Add task to end of a section",
                  "value": {
                    "data": {
                      "project": "13579",
                      "section": "987654"
                    }
                  }
                }
              },
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TaskAddProjectRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The project to add the task to.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully added the specified project to the task."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:write"
            ]
          }
        ],
        "summary": "Add a project to a task",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}~1addProject/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.tasks.addProjectForTask(taskGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The project to add the task to.\nlet task_gid = \"321654\"; // String | The task to operate on.\n\ntasksApiInstance.addProjectForTask(body, task_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.addProjectForTask(taskGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The project to add the task to.\ntask_gid = \"321654\" # str | The task to operate on.\n\n\ntry:\n    # Add a project to a task\n    api_response = tasks_api_instance.add_project_for_task(body, task_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->add_project_for_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.add_project_for_task(task_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->addProjectForTask($task_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.add_project_for_task(task_gid: 'task_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/tasks/{task_gid}/addTag": {
      "parameters": [
        {
          "$ref": "#/components/parameters/task_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>tasks:write</code>\n\nAdds a tag to a task. Returns an empty data block.",
        "operationId": "addTagForTask",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TaskAddTagRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The tag to add to the task.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully added the specified tag to the task."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:write"
            ]
          }
        ],
        "summary": "Add a tag to a task",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}~1addTag/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.tasks.addTagForTask(taskGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The tag to add to the task.\nlet task_gid = \"321654\"; // String | The task to operate on.\n\ntasksApiInstance.addTagForTask(body, task_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.addTagForTask(taskGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The tag to add to the task.\ntask_gid = \"321654\" # str | The task to operate on.\n\n\ntry:\n    # Add a tag to a task\n    api_response = tasks_api_instance.add_tag_for_task(body, task_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->add_tag_for_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.add_tag_for_task(task_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->addTagForTask($task_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.add_tag_for_task(task_gid: 'task_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/tasks/{task_gid}/dependencies": {
      "get": {
        "description": "<b>Required scope: </b><code>tasks:read</code>\n\nReturns the compact representations of all of the dependencies of a task.",
        "operationId": "getDependenciesForTask",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "actual_time_minutes",
              "approval_status",
              "assigned_by",
              "assigned_by.name",
              "assignee",
              "assignee.name",
              "assignee_section",
              "assignee_section.name",
              "assignee_status",
              "completed",
              "completed_at",
              "completed_by",
              "completed_by.name",
              "created_at",
              "created_by",
              "custom_fields",
              "custom_fields.asana_created_field",
              "custom_fields.created_by",
              "custom_fields.created_by.name",
              "custom_fields.currency_code",
              "custom_fields.custom_label",
              "custom_fields.custom_label_position",
              "custom_fields.date_value",
              "custom_fields.date_value.date",
              "custom_fields.date_value.date_time",
              "custom_fields.default_access_level",
              "custom_fields.description",
              "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.format",
              "custom_fields.has_notifications_enabled",
              "custom_fields.html_text_value",
              "custom_fields.id_prefix",
              "custom_fields.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_global_to_workspace",
              "custom_fields.is_lookup_field",
              "custom_fields.is_value_read_only",
              "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.people_value",
              "custom_fields.people_value.name",
              "custom_fields.precision",
              "custom_fields.privacy_setting",
              "custom_fields.reference_value",
              "custom_fields.reference_value.name",
              "custom_fields.representation_type",
              "custom_fields.resource_subtype",
              "custom_fields.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "custom_type_status_option",
              "custom_type_status_option.name",
              "dependencies",
              "dependents",
              "due_at",
              "due_on",
              "effective_memberships",
              "external",
              "external.data",
              "followers",
              "followers.name",
              "has_subtasks_date_mismatch",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_notes",
              "is_rendered_as_separator",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "memberships",
              "memberships.project",
              "memberships.project.name",
              "memberships.project.resource_subtype",
              "memberships.section",
              "memberships.section.name",
              "modified_at",
              "name",
              "notes",
              "num_hearts",
              "num_likes",
              "num_subtasks",
              "offset",
              "parent",
              "parent.created_by",
              "parent.name",
              "parent.resource_subtype",
              "path",
              "permalink_url",
              "projects",
              "projects.name",
              "projects.resource_subtype",
              "resource_subtype",
              "start_at",
              "start_on",
              "tags",
              "tags.name",
              "uri",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "actual_time_minutes",
                  "approval_status",
                  "assigned_by",
                  "assigned_by.name",
                  "assignee",
                  "assignee.name",
                  "assignee_section",
                  "assignee_section.name",
                  "assignee_status",
                  "completed",
                  "completed_at",
                  "completed_by",
                  "completed_by.name",
                  "created_at",
                  "created_by",
                  "custom_fields",
                  "custom_fields.asana_created_field",
                  "custom_fields.created_by",
                  "custom_fields.created_by.name",
                  "custom_fields.currency_code",
                  "custom_fields.custom_label",
                  "custom_fields.custom_label_position",
                  "custom_fields.date_value",
                  "custom_fields.date_value.date",
                  "custom_fields.date_value.date_time",
                  "custom_fields.default_access_level",
                  "custom_fields.description",
                  "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.format",
                  "custom_fields.has_notifications_enabled",
                  "custom_fields.html_text_value",
                  "custom_fields.id_prefix",
                  "custom_fields.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_global_to_workspace",
                  "custom_fields.is_lookup_field",
                  "custom_fields.is_value_read_only",
                  "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.people_value",
                  "custom_fields.people_value.name",
                  "custom_fields.precision",
                  "custom_fields.privacy_setting",
                  "custom_fields.reference_value",
                  "custom_fields.reference_value.name",
                  "custom_fields.representation_type",
                  "custom_fields.resource_subtype",
                  "custom_fields.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "custom_type_status_option",
                  "custom_type_status_option.name",
                  "dependencies",
                  "dependents",
                  "due_at",
                  "due_on",
                  "effective_memberships",
                  "external",
                  "external.data",
                  "followers",
                  "followers.name",
                  "has_subtasks_date_mismatch",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_notes",
                  "is_rendered_as_separator",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "memberships",
                  "memberships.project",
                  "memberships.project.name",
                  "memberships.project.resource_subtype",
                  "memberships.section",
                  "memberships.section.name",
                  "modified_at",
                  "name",
                  "notes",
                  "num_hearts",
                  "num_likes",
                  "num_subtasks",
                  "offset",
                  "parent",
                  "parent.created_by",
                  "parent.name",
                  "parent.resource_subtype",
                  "path",
                  "permalink_url",
                  "projects",
                  "projects.name",
                  "projects.resource_subtype",
                  "resource_subtype",
                  "start_at",
                  "start_on",
                  "tags",
                  "tags.name",
                  "uri",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TaskCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TaskResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the specified task's dependencies."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:read"
            ]
          }
        ],
        "summary": "Get dependencies from a task",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}~1dependencies/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Task> result = client.tasks.getDependenciesForTask(taskGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet task_gid = \"321654\"; // String | The task to operate on.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,offset,parent,parent.created_by,parent.name,parent.resource_subtype,path,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,uri,workspace,workspace.name\"\n};\ntasksApiInstance.getDependenciesForTask(task_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.getDependenciesForTask(taskGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\ntask_gid = \"321654\" # str | The task to operate on.\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    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,offset,parent,parent.created_by,parent.name,parent.resource_subtype,path,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,uri,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get dependencies from a task\n    api_response = tasks_api_instance.get_dependencies_for_task(task_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->get_dependencies_for_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.get_dependencies_for_task(task_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->getDependenciesForTask($task_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.get_dependencies_for_task(task_gid: 'task_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/task_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/tasks/{task_gid}/dependents": {
      "get": {
        "description": "<b>Required scope: </b><code>tasks:read</code>\n\nReturns the compact representations of all of the dependents of a task.",
        "operationId": "getDependentsForTask",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "actual_time_minutes",
              "approval_status",
              "assigned_by",
              "assigned_by.name",
              "assignee",
              "assignee.name",
              "assignee_section",
              "assignee_section.name",
              "assignee_status",
              "completed",
              "completed_at",
              "completed_by",
              "completed_by.name",
              "created_at",
              "created_by",
              "custom_fields",
              "custom_fields.asana_created_field",
              "custom_fields.created_by",
              "custom_fields.created_by.name",
              "custom_fields.currency_code",
              "custom_fields.custom_label",
              "custom_fields.custom_label_position",
              "custom_fields.date_value",
              "custom_fields.date_value.date",
              "custom_fields.date_value.date_time",
              "custom_fields.default_access_level",
              "custom_fields.description",
              "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.format",
              "custom_fields.has_notifications_enabled",
              "custom_fields.html_text_value",
              "custom_fields.id_prefix",
              "custom_fields.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_global_to_workspace",
              "custom_fields.is_lookup_field",
              "custom_fields.is_value_read_only",
              "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.people_value",
              "custom_fields.people_value.name",
              "custom_fields.precision",
              "custom_fields.privacy_setting",
              "custom_fields.reference_value",
              "custom_fields.reference_value.name",
              "custom_fields.representation_type",
              "custom_fields.resource_subtype",
              "custom_fields.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "custom_type_status_option",
              "custom_type_status_option.name",
              "dependencies",
              "dependents",
              "due_at",
              "due_on",
              "effective_memberships",
              "external",
              "external.data",
              "followers",
              "followers.name",
              "has_subtasks_date_mismatch",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_notes",
              "is_rendered_as_separator",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "memberships",
              "memberships.project",
              "memberships.project.name",
              "memberships.project.resource_subtype",
              "memberships.section",
              "memberships.section.name",
              "modified_at",
              "name",
              "notes",
              "num_hearts",
              "num_likes",
              "num_subtasks",
              "offset",
              "parent",
              "parent.created_by",
              "parent.name",
              "parent.resource_subtype",
              "path",
              "permalink_url",
              "projects",
              "projects.name",
              "projects.resource_subtype",
              "resource_subtype",
              "start_at",
              "start_on",
              "tags",
              "tags.name",
              "uri",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "actual_time_minutes",
                  "approval_status",
                  "assigned_by",
                  "assigned_by.name",
                  "assignee",
                  "assignee.name",
                  "assignee_section",
                  "assignee_section.name",
                  "assignee_status",
                  "completed",
                  "completed_at",
                  "completed_by",
                  "completed_by.name",
                  "created_at",
                  "created_by",
                  "custom_fields",
                  "custom_fields.asana_created_field",
                  "custom_fields.created_by",
                  "custom_fields.created_by.name",
                  "custom_fields.currency_code",
                  "custom_fields.custom_label",
                  "custom_fields.custom_label_position",
                  "custom_fields.date_value",
                  "custom_fields.date_value.date",
                  "custom_fields.date_value.date_time",
                  "custom_fields.default_access_level",
                  "custom_fields.description",
                  "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.format",
                  "custom_fields.has_notifications_enabled",
                  "custom_fields.html_text_value",
                  "custom_fields.id_prefix",
                  "custom_fields.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_global_to_workspace",
                  "custom_fields.is_lookup_field",
                  "custom_fields.is_value_read_only",
                  "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.people_value",
                  "custom_fields.people_value.name",
                  "custom_fields.precision",
                  "custom_fields.privacy_setting",
                  "custom_fields.reference_value",
                  "custom_fields.reference_value.name",
                  "custom_fields.representation_type",
                  "custom_fields.resource_subtype",
                  "custom_fields.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "custom_type_status_option",
                  "custom_type_status_option.name",
                  "dependencies",
                  "dependents",
                  "due_at",
                  "due_on",
                  "effective_memberships",
                  "external",
                  "external.data",
                  "followers",
                  "followers.name",
                  "has_subtasks_date_mismatch",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_notes",
                  "is_rendered_as_separator",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "memberships",
                  "memberships.project",
                  "memberships.project.name",
                  "memberships.project.resource_subtype",
                  "memberships.section",
                  "memberships.section.name",
                  "modified_at",
                  "name",
                  "notes",
                  "num_hearts",
                  "num_likes",
                  "num_subtasks",
                  "offset",
                  "parent",
                  "parent.created_by",
                  "parent.name",
                  "parent.resource_subtype",
                  "path",
                  "permalink_url",
                  "projects",
                  "projects.name",
                  "projects.resource_subtype",
                  "resource_subtype",
                  "start_at",
                  "start_on",
                  "tags",
                  "tags.name",
                  "uri",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TaskCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TaskResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the specified dependents of the task."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:read"
            ]
          }
        ],
        "summary": "Get dependents from a task",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}~1dependents/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Task> result = client.tasks.getDependentsForTask(taskGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet task_gid = \"321654\"; // String | The task to operate on.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,offset,parent,parent.created_by,parent.name,parent.resource_subtype,path,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,uri,workspace,workspace.name\"\n};\ntasksApiInstance.getDependentsForTask(task_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.getDependentsForTask(taskGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\ntask_gid = \"321654\" # str | The task to operate on.\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    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,offset,parent,parent.created_by,parent.name,parent.resource_subtype,path,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,uri,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get dependents from a task\n    api_response = tasks_api_instance.get_dependents_for_task(task_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->get_dependents_for_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.get_dependents_for_task(task_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->getDependentsForTask($task_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.get_dependents_for_task(task_gid: 'task_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/task_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/tasks/{task_gid}/duplicate": {
      "parameters": [
        {
          "$ref": "#/components/parameters/task_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>tasks:write</code>\n\nCreates and returns a job that will asynchronously handle the duplication.",
        "operationId": "duplicateTask",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "dates_rollup_progress",
              "dates_rollup_progress.total_tasks",
              "dates_rollup_progress.updated_tasks",
              "new_graph_export",
              "new_graph_export.completed_at",
              "new_graph_export.created_at",
              "new_graph_export.download_url",
              "new_portfolio",
              "new_portfolio.name",
              "new_portfolio.resource_subtype",
              "new_project",
              "new_project.name",
              "new_project.resource_subtype",
              "new_project_template",
              "new_project_template.name",
              "new_resource_export",
              "new_resource_export.completed_at",
              "new_resource_export.created_at",
              "new_resource_export.download_url",
              "new_task",
              "new_task.created_by",
              "new_task.name",
              "new_task.resource_subtype",
              "resource_subtype",
              "status"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "dates_rollup_progress",
                  "dates_rollup_progress.total_tasks",
                  "dates_rollup_progress.updated_tasks",
                  "new_graph_export",
                  "new_graph_export.completed_at",
                  "new_graph_export.created_at",
                  "new_graph_export.download_url",
                  "new_portfolio",
                  "new_portfolio.name",
                  "new_portfolio.resource_subtype",
                  "new_project",
                  "new_project.name",
                  "new_project.resource_subtype",
                  "new_project_template",
                  "new_project_template.name",
                  "new_resource_export",
                  "new_resource_export.completed_at",
                  "new_resource_export.created_at",
                  "new_resource_export.download_url",
                  "new_task",
                  "new_task.created_by",
                  "new_task.name",
                  "new_task.resource_subtype",
                  "resource_subtype",
                  "status"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TaskDuplicateRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Describes the duplicate's name and the fields that will be duplicated.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/JobResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__JobResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created the job to handle duplication."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:write"
            ]
          }
        ],
        "summary": "Duplicate a task",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}~1duplicate/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJob result = client.tasks.duplicateTask(taskGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | Describes the duplicate's name and the fields that will be duplicated.\nlet task_gid = \"321654\"; // String | The task to operate on.\nlet opts = { \n    'opt_fields': \"dates_rollup_progress,dates_rollup_progress.total_tasks,dates_rollup_progress.updated_tasks,new_graph_export,new_graph_export.completed_at,new_graph_export.created_at,new_graph_export.download_url,new_portfolio,new_portfolio.name,new_portfolio.resource_subtype,new_project,new_project.name,new_project.resource_subtype,new_project_template,new_project_template.name,new_resource_export,new_resource_export.completed_at,new_resource_export.created_at,new_resource_export.download_url,new_task,new_task.created_by,new_task.name,new_task.resource_subtype,resource_subtype,status\"\n};\ntasksApiInstance.duplicateTask(body, task_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.duplicateTask(taskGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | Describes the duplicate's name and the fields that will be duplicated.\ntask_gid = \"321654\" # str | The task to operate on.\nopts = {\n    'opt_fields': \"dates_rollup_progress,dates_rollup_progress.total_tasks,dates_rollup_progress.updated_tasks,new_graph_export,new_graph_export.completed_at,new_graph_export.created_at,new_graph_export.download_url,new_portfolio,new_portfolio.name,new_portfolio.resource_subtype,new_project,new_project.name,new_project.resource_subtype,new_project_template,new_project_template.name,new_resource_export,new_resource_export.completed_at,new_resource_export.created_at,new_resource_export.download_url,new_task,new_task.created_by,new_task.name,new_task.resource_subtype,resource_subtype,status\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Duplicate a task\n    api_response = tasks_api_instance.duplicate_task(body, task_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->duplicate_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.duplicate_task(task_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->duplicateTask($task_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.duplicate_task(task_gid: 'task_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/tasks/{task_gid}/projects": {
      "get": {
        "description": "<b>Required scope: </b><code>projects:read</code>\n\nReturns a compact representation of all of the projects the task is in.",
        "operationId": "getProjectsForTask",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "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.default_access_level",
              "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.html_text_value",
              "custom_field_settings.custom_field.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_global_to_workspace",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.privacy_setting",
              "custom_field_settings.custom_field.reference_value",
              "custom_field_settings.custom_field.reference_value.name",
              "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.parent.resource_subtype",
              "custom_field_settings.project",
              "custom_field_settings.project.name",
              "custom_field_settings.project.resource_subtype",
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "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",
              "resource_subtype",
              "start_on",
              "team",
              "team.name",
              "uri",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "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.default_access_level",
                  "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.html_text_value",
                  "custom_field_settings.custom_field.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_global_to_workspace",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.privacy_setting",
                  "custom_field_settings.custom_field.reference_value",
                  "custom_field_settings.custom_field.reference_value.name",
                  "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.parent.resource_subtype",
                  "custom_field_settings.project",
                  "custom_field_settings.project.name",
                  "custom_field_settings.project.resource_subtype",
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "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",
                  "resource_subtype",
                  "start_on",
                  "team",
                  "team.name",
                  "uri",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/ProjectCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ProjectResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the projects for the given task."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "projects:read"
            ]
          }
        ],
        "summary": "Get projects a task is in",
        "tags": [
          "Projects"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}~1projects/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Project> result = client.projects.getProjectsForTask(taskGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectsApiInstance = new Asana.ProjectsApi(client);\nlet task_gid = \"321654\"; // String | The task to operate on.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'include_inherited_projects': 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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,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,resource_subtype,start_on,team,team.name,uri,workspace,workspace.name\"\n};\nprojectsApiInstance.getProjectsForTask(task_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projects.getProjectsForTask(taskGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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)\ntask_gid = \"321654\" # str | The task to operate on.\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    'include_inherited_projects': False, # bool | Opt-in, read-only. When `true`, the response also includes projects the task inherits from its ancestor tasks (in addition to its direct projects). Defaults to `false`, in which case only direct projects are returned.\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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,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,resource_subtype,start_on,team,team.name,uri,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get projects a task is in\n    api_response = projects_api_instance.get_projects_for_task(task_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectsApi->get_projects_for_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.projects.get_projects_for_task(task_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projects->getProjectsForTask($task_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "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_for_task(task_gid: 'task_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/task_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        },
        {
          "description": "Opt-in, read-only. When `true`, the response also includes projects the task inherits from its ancestor tasks (in addition to its direct projects). Defaults to `false`, in which case only direct projects are returned.",
          "example": false,
          "in": "query",
          "name": "include_inherited_projects",
          "schema": {
            "default": false,
            "type": "boolean"
          }
        }
      ]
    },
    "/tasks/{task_gid}/removeDependencies": {
      "parameters": [
        {
          "$ref": "#/components/parameters/task_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>tasks:write</code>\n\nUnlinks a set of dependencies from this task.",
        "operationId": "removeDependenciesForTask",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/ModifyDependenciesRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The list of tasks to unlink as dependencies.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully unlinked the dependencies from the specified task."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:write"
            ]
          }
        ],
        "summary": "Unlink dependencies from a task",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}~1removeDependencies/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.tasks.removeDependenciesForTask(taskGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The list of tasks to unlink as dependencies.\nlet task_gid = \"321654\"; // String | The task to operate on.\n\ntasksApiInstance.removeDependenciesForTask(body, task_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.removeDependenciesForTask(taskGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The list of tasks to unlink as dependencies.\ntask_gid = \"321654\" # str | The task to operate on.\n\n\ntry:\n    # Unlink dependencies from a task\n    api_response = tasks_api_instance.remove_dependencies_for_task(body, task_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->remove_dependencies_for_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.remove_dependencies_for_task(task_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->removeDependenciesForTask($task_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.remove_dependencies_for_task(task_gid: 'task_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/tasks/{task_gid}/removeDependents": {
      "parameters": [
        {
          "$ref": "#/components/parameters/task_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>tasks:write</code>\n\nUnlinks a set of dependents from this task.",
        "operationId": "removeDependentsForTask",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/ModifyDependentsRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The list of tasks to remove as dependents.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully unlinked the specified tasks as dependents."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:write"
            ]
          }
        ],
        "summary": "Unlink dependents from a task",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}~1removeDependents/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.tasks.removeDependentsForTask(taskGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The list of tasks to remove as dependents.\nlet task_gid = \"321654\"; // String | The task to operate on.\n\ntasksApiInstance.removeDependentsForTask(body, task_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.removeDependentsForTask(taskGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The list of tasks to remove as dependents.\ntask_gid = \"321654\" # str | The task to operate on.\n\n\ntry:\n    # Unlink dependents from a task\n    api_response = tasks_api_instance.remove_dependents_for_task(body, task_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->remove_dependents_for_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.remove_dependents_for_task(task_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->removeDependentsForTask($task_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.remove_dependents_for_task(task_gid: 'task_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/tasks/{task_gid}/removeFollowers": {
      "parameters": [
        {
          "$ref": "#/components/parameters/task_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>tasks:write</code>\n\nRemoves each of the specified followers from the task if they are following. Returns the complete, updated record for the affected task.",
        "operationId": "removeFollowerForTask",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "actual_time_minutes",
              "approval_status",
              "assigned_by",
              "assigned_by.name",
              "assignee",
              "assignee.name",
              "assignee_section",
              "assignee_section.name",
              "assignee_status",
              "completed",
              "completed_at",
              "completed_by",
              "completed_by.name",
              "created_at",
              "created_by",
              "custom_fields",
              "custom_fields.asana_created_field",
              "custom_fields.created_by",
              "custom_fields.created_by.name",
              "custom_fields.currency_code",
              "custom_fields.custom_label",
              "custom_fields.custom_label_position",
              "custom_fields.date_value",
              "custom_fields.date_value.date",
              "custom_fields.date_value.date_time",
              "custom_fields.default_access_level",
              "custom_fields.description",
              "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.format",
              "custom_fields.has_notifications_enabled",
              "custom_fields.html_text_value",
              "custom_fields.id_prefix",
              "custom_fields.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_global_to_workspace",
              "custom_fields.is_lookup_field",
              "custom_fields.is_value_read_only",
              "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.people_value",
              "custom_fields.people_value.name",
              "custom_fields.precision",
              "custom_fields.privacy_setting",
              "custom_fields.reference_value",
              "custom_fields.reference_value.name",
              "custom_fields.representation_type",
              "custom_fields.resource_subtype",
              "custom_fields.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "custom_type_status_option",
              "custom_type_status_option.name",
              "dependencies",
              "dependents",
              "due_at",
              "due_on",
              "effective_memberships",
              "external",
              "external.data",
              "followers",
              "followers.name",
              "has_subtasks_date_mismatch",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_notes",
              "is_rendered_as_separator",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "memberships",
              "memberships.project",
              "memberships.project.name",
              "memberships.project.resource_subtype",
              "memberships.section",
              "memberships.section.name",
              "modified_at",
              "name",
              "notes",
              "num_hearts",
              "num_likes",
              "num_subtasks",
              "parent",
              "parent.created_by",
              "parent.name",
              "parent.resource_subtype",
              "permalink_url",
              "projects",
              "projects.name",
              "projects.resource_subtype",
              "resource_subtype",
              "start_at",
              "start_on",
              "tags",
              "tags.name",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "actual_time_minutes",
                  "approval_status",
                  "assigned_by",
                  "assigned_by.name",
                  "assignee",
                  "assignee.name",
                  "assignee_section",
                  "assignee_section.name",
                  "assignee_status",
                  "completed",
                  "completed_at",
                  "completed_by",
                  "completed_by.name",
                  "created_at",
                  "created_by",
                  "custom_fields",
                  "custom_fields.asana_created_field",
                  "custom_fields.created_by",
                  "custom_fields.created_by.name",
                  "custom_fields.currency_code",
                  "custom_fields.custom_label",
                  "custom_fields.custom_label_position",
                  "custom_fields.date_value",
                  "custom_fields.date_value.date",
                  "custom_fields.date_value.date_time",
                  "custom_fields.default_access_level",
                  "custom_fields.description",
                  "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.format",
                  "custom_fields.has_notifications_enabled",
                  "custom_fields.html_text_value",
                  "custom_fields.id_prefix",
                  "custom_fields.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_global_to_workspace",
                  "custom_fields.is_lookup_field",
                  "custom_fields.is_value_read_only",
                  "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.people_value",
                  "custom_fields.people_value.name",
                  "custom_fields.precision",
                  "custom_fields.privacy_setting",
                  "custom_fields.reference_value",
                  "custom_fields.reference_value.name",
                  "custom_fields.representation_type",
                  "custom_fields.resource_subtype",
                  "custom_fields.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "custom_type_status_option",
                  "custom_type_status_option.name",
                  "dependencies",
                  "dependents",
                  "due_at",
                  "due_on",
                  "effective_memberships",
                  "external",
                  "external.data",
                  "followers",
                  "followers.name",
                  "has_subtasks_date_mismatch",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_notes",
                  "is_rendered_as_separator",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "memberships",
                  "memberships.project",
                  "memberships.project.name",
                  "memberships.project.resource_subtype",
                  "memberships.section",
                  "memberships.section.name",
                  "modified_at",
                  "name",
                  "notes",
                  "num_hearts",
                  "num_likes",
                  "num_subtasks",
                  "parent",
                  "parent.created_by",
                  "parent.name",
                  "parent.resource_subtype",
                  "permalink_url",
                  "projects",
                  "projects.name",
                  "projects.resource_subtype",
                  "resource_subtype",
                  "start_at",
                  "start_on",
                  "tags",
                  "tags.name",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TaskRemoveFollowersRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The followers to remove from the task.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TaskResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TaskResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully removed the specified followers from the task."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:write"
            ]
          }
        ],
        "summary": "Remove followers from a task",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}~1removeFollowers/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nTask result = client.tasks.removeFollowerForTask(taskGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The followers to remove from the task.\nlet task_gid = \"321654\"; // String | The task to operate on.\nlet opts = { \n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,parent,parent.created_by,parent.name,parent.resource_subtype,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,workspace,workspace.name\"\n};\ntasksApiInstance.removeFollowerForTask(body, task_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.removeFollowerForTask(taskGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The followers to remove from the task.\ntask_gid = \"321654\" # str | The task to operate on.\nopts = {\n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,parent,parent.created_by,parent.name,parent.resource_subtype,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Remove followers from a task\n    api_response = tasks_api_instance.remove_follower_for_task(body, task_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->remove_follower_for_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.remove_follower_for_task(task_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->removeFollowerForTask($task_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.remove_follower_for_task(task_gid: 'task_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/tasks/{task_gid}/removeProject": {
      "parameters": [
        {
          "$ref": "#/components/parameters/task_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>tasks:write</code>\n\nRemoves the task from the specified project. The task will still exist in\nthe system, but it will not be in the project anymore.\n\nReturns an empty data block.",
        "operationId": "removeProjectForTask",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TaskRemoveProjectRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The project to remove the task from.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully removed the specified project from the task."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:write"
            ]
          }
        ],
        "summary": "Remove a project from a task",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}~1removeProject/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.tasks.removeProjectForTask(taskGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The project to remove the task from.\nlet task_gid = \"321654\"; // String | The task to operate on.\n\ntasksApiInstance.removeProjectForTask(body, task_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.removeProjectForTask(taskGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The project to remove the task from.\ntask_gid = \"321654\" # str | The task to operate on.\n\n\ntry:\n    # Remove a project from a task\n    api_response = tasks_api_instance.remove_project_for_task(body, task_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->remove_project_for_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.remove_project_for_task(task_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->removeProjectForTask($task_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.remove_project_for_task(task_gid: 'task_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/tasks/{task_gid}/removeTag": {
      "parameters": [
        {
          "$ref": "#/components/parameters/task_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>tasks:write</code>\n\nRemoves a tag from a task. Returns an empty data block.",
        "operationId": "removeTagForTask",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TaskRemoveTagRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The tag to remove from the task.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully removed the specified tag from the task."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:write"
            ]
          }
        ],
        "summary": "Remove a tag from a task",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}~1removeTag/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.tasks.removeTagForTask(taskGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The tag to remove from the task.\nlet task_gid = \"321654\"; // String | The task to operate on.\n\ntasksApiInstance.removeTagForTask(body, task_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.removeTagForTask(taskGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The tag to remove from the task.\ntask_gid = \"321654\" # str | The task to operate on.\n\n\ntry:\n    # Remove a tag from a task\n    api_response = tasks_api_instance.remove_tag_for_task(body, task_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->remove_tag_for_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.remove_tag_for_task(task_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->removeTagForTask($task_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.remove_tag_for_task(task_gid: 'task_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/tasks/{task_gid}/rollup": {
      "parameters": [
        {
          "$ref": "#/components/parameters/task_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>tasks:write</code>\n\nCreates and returns a job that will asynchronously roll up the subtask dates for the subtask tree rooted at the task with the given `task_gid`. Each parent task's start and due dates are reconciled to cover its descendants' date range.",
        "operationId": "rollupTask",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "dates_rollup_progress",
              "dates_rollup_progress.total_tasks",
              "dates_rollup_progress.updated_tasks",
              "new_graph_export",
              "new_graph_export.completed_at",
              "new_graph_export.created_at",
              "new_graph_export.download_url",
              "new_portfolio",
              "new_portfolio.name",
              "new_portfolio.resource_subtype",
              "new_project",
              "new_project.name",
              "new_project.resource_subtype",
              "new_project_template",
              "new_project_template.name",
              "new_resource_export",
              "new_resource_export.completed_at",
              "new_resource_export.created_at",
              "new_resource_export.download_url",
              "new_task",
              "new_task.created_by",
              "new_task.name",
              "new_task.resource_subtype",
              "resource_subtype",
              "status"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "dates_rollup_progress",
                  "dates_rollup_progress.total_tasks",
                  "dates_rollup_progress.updated_tasks",
                  "new_graph_export",
                  "new_graph_export.completed_at",
                  "new_graph_export.created_at",
                  "new_graph_export.download_url",
                  "new_portfolio",
                  "new_portfolio.name",
                  "new_portfolio.resource_subtype",
                  "new_project",
                  "new_project.name",
                  "new_project.resource_subtype",
                  "new_project_template",
                  "new_project_template.name",
                  "new_resource_export",
                  "new_resource_export.completed_at",
                  "new_resource_export.created_at",
                  "new_resource_export.download_url",
                  "new_task",
                  "new_task.created_by",
                  "new_task.name",
                  "new_task.resource_subtype",
                  "resource_subtype",
                  "status"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/JobResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__JobResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created a job to roll up the task's subtask dates."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:write"
            ]
          }
        ],
        "summary": "Roll up subtask dates for a task",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}~1rollup/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet task_gid = \"321654\"; // String | The task to operate on.\nlet opts = { \n    'opt_fields': \"dates_rollup_progress,dates_rollup_progress.total_tasks,dates_rollup_progress.updated_tasks,new_graph_export,new_graph_export.completed_at,new_graph_export.created_at,new_graph_export.download_url,new_portfolio,new_portfolio.name,new_portfolio.resource_subtype,new_project,new_project.name,new_project.resource_subtype,new_project_template,new_project_template.name,new_resource_export,new_resource_export.completed_at,new_resource_export.created_at,new_resource_export.download_url,new_task,new_task.created_by,new_task.name,new_task.resource_subtype,resource_subtype,status\"\n};\ntasksApiInstance.rollupTask(task_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\ntask_gid = \"321654\" # str | The task to operate on.\nopts = {\n    'opt_fields': \"dates_rollup_progress,dates_rollup_progress.total_tasks,dates_rollup_progress.updated_tasks,new_graph_export,new_graph_export.completed_at,new_graph_export.created_at,new_graph_export.download_url,new_portfolio,new_portfolio.name,new_portfolio.resource_subtype,new_project,new_project.name,new_project.resource_subtype,new_project_template,new_project_template.name,new_resource_export,new_resource_export.completed_at,new_resource_export.created_at,new_resource_export.download_url,new_task,new_task.created_by,new_task.name,new_task.resource_subtype,resource_subtype,status\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Roll up subtask dates for a task\n    api_response = tasks_api_instance.rollup_task(task_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->rollup_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/tasks/{task_gid}/setParent": {
      "parameters": [
        {
          "$ref": "#/components/parameters/task_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>tasks:write</code>\n\nUpdates the parent of a given task. This endpoint can be used to make a task a subtask of another task, or to remove its existing parent.\nWhen using `insert_before` and `insert_after`, at most one of those two options can be specified, and they must already be subtasks of the parent.\nReturns the complete, updated record of the affected [task](/reference/tasks#/task).",
        "operationId": "setParentForTask",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "actual_time_minutes",
              "approval_status",
              "assigned_by",
              "assigned_by.name",
              "assignee",
              "assignee.name",
              "assignee_section",
              "assignee_section.name",
              "assignee_status",
              "completed",
              "completed_at",
              "completed_by",
              "completed_by.name",
              "created_at",
              "created_by",
              "custom_fields",
              "custom_fields.asana_created_field",
              "custom_fields.created_by",
              "custom_fields.created_by.name",
              "custom_fields.currency_code",
              "custom_fields.custom_label",
              "custom_fields.custom_label_position",
              "custom_fields.date_value",
              "custom_fields.date_value.date",
              "custom_fields.date_value.date_time",
              "custom_fields.default_access_level",
              "custom_fields.description",
              "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.format",
              "custom_fields.has_notifications_enabled",
              "custom_fields.html_text_value",
              "custom_fields.id_prefix",
              "custom_fields.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_global_to_workspace",
              "custom_fields.is_lookup_field",
              "custom_fields.is_value_read_only",
              "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.people_value",
              "custom_fields.people_value.name",
              "custom_fields.precision",
              "custom_fields.privacy_setting",
              "custom_fields.reference_value",
              "custom_fields.reference_value.name",
              "custom_fields.representation_type",
              "custom_fields.resource_subtype",
              "custom_fields.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "custom_type_status_option",
              "custom_type_status_option.name",
              "dependencies",
              "dependents",
              "due_at",
              "due_on",
              "effective_memberships",
              "external",
              "external.data",
              "followers",
              "followers.name",
              "has_subtasks_date_mismatch",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_notes",
              "is_rendered_as_separator",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "memberships",
              "memberships.project",
              "memberships.project.name",
              "memberships.project.resource_subtype",
              "memberships.section",
              "memberships.section.name",
              "modified_at",
              "name",
              "notes",
              "num_hearts",
              "num_likes",
              "num_subtasks",
              "parent",
              "parent.created_by",
              "parent.name",
              "parent.resource_subtype",
              "permalink_url",
              "projects",
              "projects.name",
              "projects.resource_subtype",
              "resource_subtype",
              "start_at",
              "start_on",
              "tags",
              "tags.name",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "actual_time_minutes",
                  "approval_status",
                  "assigned_by",
                  "assigned_by.name",
                  "assignee",
                  "assignee.name",
                  "assignee_section",
                  "assignee_section.name",
                  "assignee_status",
                  "completed",
                  "completed_at",
                  "completed_by",
                  "completed_by.name",
                  "created_at",
                  "created_by",
                  "custom_fields",
                  "custom_fields.asana_created_field",
                  "custom_fields.created_by",
                  "custom_fields.created_by.name",
                  "custom_fields.currency_code",
                  "custom_fields.custom_label",
                  "custom_fields.custom_label_position",
                  "custom_fields.date_value",
                  "custom_fields.date_value.date",
                  "custom_fields.date_value.date_time",
                  "custom_fields.default_access_level",
                  "custom_fields.description",
                  "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.format",
                  "custom_fields.has_notifications_enabled",
                  "custom_fields.html_text_value",
                  "custom_fields.id_prefix",
                  "custom_fields.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_global_to_workspace",
                  "custom_fields.is_lookup_field",
                  "custom_fields.is_value_read_only",
                  "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.people_value",
                  "custom_fields.people_value.name",
                  "custom_fields.precision",
                  "custom_fields.privacy_setting",
                  "custom_fields.reference_value",
                  "custom_fields.reference_value.name",
                  "custom_fields.representation_type",
                  "custom_fields.resource_subtype",
                  "custom_fields.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "custom_type_status_option",
                  "custom_type_status_option.name",
                  "dependencies",
                  "dependents",
                  "due_at",
                  "due_on",
                  "effective_memberships",
                  "external",
                  "external.data",
                  "followers",
                  "followers.name",
                  "has_subtasks_date_mismatch",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_notes",
                  "is_rendered_as_separator",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "memberships",
                  "memberships.project",
                  "memberships.project.name",
                  "memberships.project.resource_subtype",
                  "memberships.section",
                  "memberships.section.name",
                  "modified_at",
                  "name",
                  "notes",
                  "num_hearts",
                  "num_likes",
                  "num_subtasks",
                  "parent",
                  "parent.created_by",
                  "parent.name",
                  "parent.resource_subtype",
                  "permalink_url",
                  "projects",
                  "projects.name",
                  "projects.resource_subtype",
                  "resource_subtype",
                  "start_at",
                  "start_on",
                  "tags",
                  "tags.name",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TaskSetParentRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The new parent of the subtask.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TaskResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TaskResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully changed the parent of the specified subtask."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:write"
            ]
          }
        ],
        "summary": "Set the parent of a task",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}~1setParent/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nTask result = client.tasks.setParentForTask(taskGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The new parent of the subtask.\nlet task_gid = \"321654\"; // String | The task to operate on.\nlet opts = { \n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,parent,parent.created_by,parent.name,parent.resource_subtype,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,workspace,workspace.name\"\n};\ntasksApiInstance.setParentForTask(body, task_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.setParentForTask(taskGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The new parent of the subtask.\ntask_gid = \"321654\" # str | The task to operate on.\nopts = {\n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,parent,parent.created_by,parent.name,parent.resource_subtype,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Set the parent of a task\n    api_response = tasks_api_instance.set_parent_for_task(body, task_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->set_parent_for_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.set_parent_for_task(task_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->setParentForTask($task_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.set_parent_for_task(task_gid: 'task_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/tasks/{task_gid}/stories": {
      "get": {
        "description": "<b>Required scope: </b><code>stories:read</code>\n\nReturns the compact records for all stories on the task.",
        "operationId": "getStoriesForTask",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "$ref": "#/components/parameters/story_created_after"
          },
          {
            "$ref": "#/components/parameters/story_resource_subtype"
          },
          {
            "$ref": "#/components/parameters/story_sort_ascending"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "anchor_gid",
              "assignee",
              "assignee.name",
              "comment_gid",
              "created_at",
              "created_by",
              "created_by.name",
              "custom_field",
              "custom_field.date_value",
              "custom_field.date_value.date",
              "custom_field.date_value.date_time",
              "custom_field.display_value",
              "custom_field.enabled",
              "custom_field.enum_options",
              "custom_field.enum_options.color",
              "custom_field.enum_options.enabled",
              "custom_field.enum_options.name",
              "custom_field.enum_value",
              "custom_field.enum_value.color",
              "custom_field.enum_value.enabled",
              "custom_field.enum_value.name",
              "custom_field.id_prefix",
              "custom_field.input_restrictions",
              "custom_field.is_formula_field",
              "custom_field.is_lookup_field",
              "custom_field.multi_enum_values",
              "custom_field.multi_enum_values.color",
              "custom_field.multi_enum_values.enabled",
              "custom_field.multi_enum_values.name",
              "custom_field.name",
              "custom_field.number_value",
              "custom_field.representation_type",
              "custom_field.text_value",
              "custom_field.type",
              "dependency",
              "dependency.created_by",
              "dependency.name",
              "dependency.resource_subtype",
              "duplicate_of",
              "duplicate_of.created_by",
              "duplicate_of.name",
              "duplicate_of.resource_subtype",
              "duplicated_from",
              "duplicated_from.created_by",
              "duplicated_from.name",
              "duplicated_from.resource_subtype",
              "follower",
              "follower.name",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_text",
              "is_editable",
              "is_edited",
              "is_pinned",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "new_approval_status",
              "new_date_value",
              "new_dates",
              "new_dates.due_at",
              "new_dates.due_on",
              "new_dates.start_on",
              "new_enum_value",
              "new_enum_value.color",
              "new_enum_value.enabled",
              "new_enum_value.name",
              "new_multi_enum_values",
              "new_multi_enum_values.color",
              "new_multi_enum_values.enabled",
              "new_multi_enum_values.name",
              "new_name",
              "new_number_value",
              "new_people_value",
              "new_people_value.name",
              "new_resource_subtype",
              "new_section",
              "new_section.name",
              "new_text_value",
              "num_hearts",
              "num_likes",
              "offset",
              "old_approval_status",
              "old_date_value",
              "old_dates",
              "old_dates.due_at",
              "old_dates.due_on",
              "old_dates.start_on",
              "old_enum_value",
              "old_enum_value.color",
              "old_enum_value.enabled",
              "old_enum_value.name",
              "old_multi_enum_values",
              "old_multi_enum_values.color",
              "old_multi_enum_values.enabled",
              "old_multi_enum_values.name",
              "old_name",
              "old_number_value",
              "old_people_value",
              "old_people_value.name",
              "old_resource_subtype",
              "old_section",
              "old_section.name",
              "old_text_value",
              "path",
              "previews",
              "previews.fallback",
              "previews.footer",
              "previews.header",
              "previews.header_link",
              "previews.html_text",
              "previews.text",
              "previews.title",
              "previews.title_link",
              "project",
              "project.name",
              "project.resource_subtype",
              "reaction_summary",
              "reaction_summary.count",
              "reaction_summary.emoji_base",
              "reaction_summary.reacted",
              "reaction_summary.variant",
              "resource_subtype",
              "source",
              "sticker_name",
              "story",
              "story.anchor_gid",
              "story.comment_gid",
              "story.created_at",
              "story.created_by",
              "story.created_by.name",
              "story.resource_subtype",
              "story.text",
              "tag",
              "tag.name",
              "target",
              "target.created_by",
              "target.name",
              "target.resource_subtype",
              "task",
              "task.created_by",
              "task.name",
              "task.resource_subtype",
              "text",
              "type",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "anchor_gid",
                  "assignee",
                  "assignee.name",
                  "comment_gid",
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "custom_field",
                  "custom_field.date_value",
                  "custom_field.date_value.date",
                  "custom_field.date_value.date_time",
                  "custom_field.display_value",
                  "custom_field.enabled",
                  "custom_field.enum_options",
                  "custom_field.enum_options.color",
                  "custom_field.enum_options.enabled",
                  "custom_field.enum_options.name",
                  "custom_field.enum_value",
                  "custom_field.enum_value.color",
                  "custom_field.enum_value.enabled",
                  "custom_field.enum_value.name",
                  "custom_field.id_prefix",
                  "custom_field.input_restrictions",
                  "custom_field.is_formula_field",
                  "custom_field.is_lookup_field",
                  "custom_field.multi_enum_values",
                  "custom_field.multi_enum_values.color",
                  "custom_field.multi_enum_values.enabled",
                  "custom_field.multi_enum_values.name",
                  "custom_field.name",
                  "custom_field.number_value",
                  "custom_field.representation_type",
                  "custom_field.text_value",
                  "custom_field.type",
                  "dependency",
                  "dependency.created_by",
                  "dependency.name",
                  "dependency.resource_subtype",
                  "duplicate_of",
                  "duplicate_of.created_by",
                  "duplicate_of.name",
                  "duplicate_of.resource_subtype",
                  "duplicated_from",
                  "duplicated_from.created_by",
                  "duplicated_from.name",
                  "duplicated_from.resource_subtype",
                  "follower",
                  "follower.name",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_text",
                  "is_editable",
                  "is_edited",
                  "is_pinned",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "new_approval_status",
                  "new_date_value",
                  "new_dates",
                  "new_dates.due_at",
                  "new_dates.due_on",
                  "new_dates.start_on",
                  "new_enum_value",
                  "new_enum_value.color",
                  "new_enum_value.enabled",
                  "new_enum_value.name",
                  "new_multi_enum_values",
                  "new_multi_enum_values.color",
                  "new_multi_enum_values.enabled",
                  "new_multi_enum_values.name",
                  "new_name",
                  "new_number_value",
                  "new_people_value",
                  "new_people_value.name",
                  "new_resource_subtype",
                  "new_section",
                  "new_section.name",
                  "new_text_value",
                  "num_hearts",
                  "num_likes",
                  "offset",
                  "old_approval_status",
                  "old_date_value",
                  "old_dates",
                  "old_dates.due_at",
                  "old_dates.due_on",
                  "old_dates.start_on",
                  "old_enum_value",
                  "old_enum_value.color",
                  "old_enum_value.enabled",
                  "old_enum_value.name",
                  "old_multi_enum_values",
                  "old_multi_enum_values.color",
                  "old_multi_enum_values.enabled",
                  "old_multi_enum_values.name",
                  "old_name",
                  "old_number_value",
                  "old_people_value",
                  "old_people_value.name",
                  "old_resource_subtype",
                  "old_section",
                  "old_section.name",
                  "old_text_value",
                  "path",
                  "previews",
                  "previews.fallback",
                  "previews.footer",
                  "previews.header",
                  "previews.header_link",
                  "previews.html_text",
                  "previews.text",
                  "previews.title",
                  "previews.title_link",
                  "project",
                  "project.name",
                  "project.resource_subtype",
                  "reaction_summary",
                  "reaction_summary.count",
                  "reaction_summary.emoji_base",
                  "reaction_summary.reacted",
                  "reaction_summary.variant",
                  "resource_subtype",
                  "source",
                  "sticker_name",
                  "story",
                  "story.anchor_gid",
                  "story.comment_gid",
                  "story.created_at",
                  "story.created_by",
                  "story.created_by.name",
                  "story.resource_subtype",
                  "story.text",
                  "tag",
                  "tag.name",
                  "target",
                  "target.created_by",
                  "target.name",
                  "target.resource_subtype",
                  "task",
                  "task.created_by",
                  "task.name",
                  "task.resource_subtype",
                  "text",
                  "type",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/StoryCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__StoryResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the specified task's stories."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "stories:read"
            ]
          }
        ],
        "summary": "Get stories from a task",
        "tags": [
          "Stories"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}~1stories/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Story> result = client.stories.getStoriesForTask(taskGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet storiesApiInstance = new Asana.StoriesApi(client);\nlet task_gid = \"321654\"; // String | The task to operate on.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'created_after': \"2012-02-22T02:06:58.158Z\", \n    'resource_subtype': \"comment_added\", \n    'sort_ascending': true, \n    'opt_fields': \"anchor_gid,assignee,assignee.name,comment_gid,created_at,created_by,created_by.name,custom_field,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_lookup_field,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.representation_type,custom_field.text_value,custom_field.type,dependency,dependency.created_by,dependency.name,dependency.resource_subtype,duplicate_of,duplicate_of.created_by,duplicate_of.name,duplicate_of.resource_subtype,duplicated_from,duplicated_from.created_by,duplicated_from.name,duplicated_from.resource_subtype,follower,follower.name,hearted,hearts,hearts.user,hearts.user.name,html_text,is_editable,is_edited,is_pinned,liked,likes,likes.user,likes.user.name,new_approval_status,new_date_value,new_dates,new_dates.due_at,new_dates.due_on,new_dates.start_on,new_enum_value,new_enum_value.color,new_enum_value.enabled,new_enum_value.name,new_multi_enum_values,new_multi_enum_values.color,new_multi_enum_values.enabled,new_multi_enum_values.name,new_name,new_number_value,new_people_value,new_people_value.name,new_resource_subtype,new_section,new_section.name,new_text_value,num_hearts,num_likes,offset,old_approval_status,old_date_value,old_dates,old_dates.due_at,old_dates.due_on,old_dates.start_on,old_enum_value,old_enum_value.color,old_enum_value.enabled,old_enum_value.name,old_multi_enum_values,old_multi_enum_values.color,old_multi_enum_values.enabled,old_multi_enum_values.name,old_name,old_number_value,old_people_value,old_people_value.name,old_resource_subtype,old_section,old_section.name,old_text_value,path,previews,previews.fallback,previews.footer,previews.header,previews.header_link,previews.html_text,previews.text,previews.title,previews.title_link,project,project.name,project.resource_subtype,reaction_summary,reaction_summary.count,reaction_summary.emoji_base,reaction_summary.reacted,reaction_summary.variant,resource_subtype,source,sticker_name,story,story.anchor_gid,story.comment_gid,story.created_at,story.created_by,story.created_by.name,story.resource_subtype,story.text,tag,tag.name,target,target.created_by,target.name,target.resource_subtype,task,task.created_by,task.name,task.resource_subtype,text,type,uri\"\n};\nstoriesApiInstance.getStoriesForTask(task_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.stories.getStoriesForTask(taskGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nstories_api_instance = asana.StoriesApi(api_client)\ntask_gid = \"321654\" # str | The task to operate on.\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    'created_after': '2012-02-22T02:06:58.158Z', # datetime | Only return stories created after this time. Applies to every story type; pair it with `resource_subtype=comment_added` to get just the comments added since a given moment. The bound is exclusive but has second granularity: it is truncated to the start of its second before filtering, so any story created within that same second is still returned. A client polling with the `created_at` of the last story it saw should expect to see that story again, and others alongside it, and should de-duplicate on `gid`. \n    'resource_subtype': \"comment_added\", # str | Only return stories of this subtype. Only `comment_added` is supported, which narrows the response to comments and excludes activity such as assignments, due date changes, and project moves. Omit to return the full activity feed. \n    'sort_ascending': False, # bool | Creation-time order: `true` (the default) is oldest first, `false` is newest first. Pair `false` with `limit` to read only the most recent stories. Ordering is applied across the parent's stories; on a parent with an extremely large activity feed the feed may be truncated before it is ordered, so pair `false` with `created_after` to bound what is considered. \n    'opt_fields': \"anchor_gid,assignee,assignee.name,comment_gid,created_at,created_by,created_by.name,custom_field,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_lookup_field,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.representation_type,custom_field.text_value,custom_field.type,dependency,dependency.created_by,dependency.name,dependency.resource_subtype,duplicate_of,duplicate_of.created_by,duplicate_of.name,duplicate_of.resource_subtype,duplicated_from,duplicated_from.created_by,duplicated_from.name,duplicated_from.resource_subtype,follower,follower.name,hearted,hearts,hearts.user,hearts.user.name,html_text,is_editable,is_edited,is_pinned,liked,likes,likes.user,likes.user.name,new_approval_status,new_date_value,new_dates,new_dates.due_at,new_dates.due_on,new_dates.start_on,new_enum_value,new_enum_value.color,new_enum_value.enabled,new_enum_value.name,new_multi_enum_values,new_multi_enum_values.color,new_multi_enum_values.enabled,new_multi_enum_values.name,new_name,new_number_value,new_people_value,new_people_value.name,new_resource_subtype,new_section,new_section.name,new_text_value,num_hearts,num_likes,offset,old_approval_status,old_date_value,old_dates,old_dates.due_at,old_dates.due_on,old_dates.start_on,old_enum_value,old_enum_value.color,old_enum_value.enabled,old_enum_value.name,old_multi_enum_values,old_multi_enum_values.color,old_multi_enum_values.enabled,old_multi_enum_values.name,old_name,old_number_value,old_people_value,old_people_value.name,old_resource_subtype,old_section,old_section.name,old_text_value,path,previews,previews.fallback,previews.footer,previews.header,previews.header_link,previews.html_text,previews.text,previews.title,previews.title_link,project,project.name,project.resource_subtype,reaction_summary,reaction_summary.count,reaction_summary.emoji_base,reaction_summary.reacted,reaction_summary.variant,resource_subtype,source,sticker_name,story,story.anchor_gid,story.comment_gid,story.created_at,story.created_by,story.created_by.name,story.resource_subtype,story.text,tag,tag.name,target,target.created_by,target.name,target.resource_subtype,task,task.created_by,task.name,task.resource_subtype,text,type,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get stories from a task\n    api_response = stories_api_instance.get_stories_for_task(task_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling StoriesApi->get_stories_for_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.stories.get_stories_for_task(task_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->stories->getStoriesForTask($task_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.stories.get_stories_for_task(task_gid: 'task_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/task_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>stories:write</code>\n\nAdds a story to a task. This endpoint currently only allows for comment\nstories to be created. The comment will be authored by the currently\nauthenticated user, and timestamped when the server receives the request.\n\nOmit `parent_comment` to create a top-level comment. To create a threaded\nreply, pass the top-level comment's `comment_gid`, not its story `gid`.\nRetrieve it with `GET /stories/{story_gid}?opt_fields=comment_gid` or\n`GET /tasks/{task_gid}/stories?opt_fields=comment_gid,text,anchor_gid`.\nThe parent must belong to this task and must not itself be a reply.\nA top-level comment's `anchor_gid` is the task GID; a reply's `anchor_gid`\nis its parent comment's envelope GID.\n\nReturns the full record for the new story added to the task.",
        "operationId": "createStoryForTask",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "anchor_gid",
              "assignee",
              "assignee.name",
              "comment_gid",
              "created_at",
              "created_by",
              "created_by.name",
              "custom_field",
              "custom_field.date_value",
              "custom_field.date_value.date",
              "custom_field.date_value.date_time",
              "custom_field.display_value",
              "custom_field.enabled",
              "custom_field.enum_options",
              "custom_field.enum_options.color",
              "custom_field.enum_options.enabled",
              "custom_field.enum_options.name",
              "custom_field.enum_value",
              "custom_field.enum_value.color",
              "custom_field.enum_value.enabled",
              "custom_field.enum_value.name",
              "custom_field.id_prefix",
              "custom_field.input_restrictions",
              "custom_field.is_formula_field",
              "custom_field.is_lookup_field",
              "custom_field.multi_enum_values",
              "custom_field.multi_enum_values.color",
              "custom_field.multi_enum_values.enabled",
              "custom_field.multi_enum_values.name",
              "custom_field.name",
              "custom_field.number_value",
              "custom_field.representation_type",
              "custom_field.text_value",
              "custom_field.type",
              "dependency",
              "dependency.created_by",
              "dependency.name",
              "dependency.resource_subtype",
              "duplicate_of",
              "duplicate_of.created_by",
              "duplicate_of.name",
              "duplicate_of.resource_subtype",
              "duplicated_from",
              "duplicated_from.created_by",
              "duplicated_from.name",
              "duplicated_from.resource_subtype",
              "follower",
              "follower.name",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_text",
              "is_editable",
              "is_edited",
              "is_pinned",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "new_approval_status",
              "new_date_value",
              "new_dates",
              "new_dates.due_at",
              "new_dates.due_on",
              "new_dates.start_on",
              "new_enum_value",
              "new_enum_value.color",
              "new_enum_value.enabled",
              "new_enum_value.name",
              "new_multi_enum_values",
              "new_multi_enum_values.color",
              "new_multi_enum_values.enabled",
              "new_multi_enum_values.name",
              "new_name",
              "new_number_value",
              "new_people_value",
              "new_people_value.name",
              "new_resource_subtype",
              "new_section",
              "new_section.name",
              "new_text_value",
              "num_hearts",
              "num_likes",
              "old_approval_status",
              "old_date_value",
              "old_dates",
              "old_dates.due_at",
              "old_dates.due_on",
              "old_dates.start_on",
              "old_enum_value",
              "old_enum_value.color",
              "old_enum_value.enabled",
              "old_enum_value.name",
              "old_multi_enum_values",
              "old_multi_enum_values.color",
              "old_multi_enum_values.enabled",
              "old_multi_enum_values.name",
              "old_name",
              "old_number_value",
              "old_people_value",
              "old_people_value.name",
              "old_resource_subtype",
              "old_section",
              "old_section.name",
              "old_text_value",
              "previews",
              "previews.fallback",
              "previews.footer",
              "previews.header",
              "previews.header_link",
              "previews.html_text",
              "previews.text",
              "previews.title",
              "previews.title_link",
              "project",
              "project.name",
              "project.resource_subtype",
              "reaction_summary",
              "reaction_summary.count",
              "reaction_summary.emoji_base",
              "reaction_summary.reacted",
              "reaction_summary.variant",
              "resource_subtype",
              "source",
              "sticker_name",
              "story",
              "story.anchor_gid",
              "story.comment_gid",
              "story.created_at",
              "story.created_by",
              "story.created_by.name",
              "story.resource_subtype",
              "story.text",
              "tag",
              "tag.name",
              "target",
              "target.created_by",
              "target.name",
              "target.resource_subtype",
              "task",
              "task.created_by",
              "task.name",
              "task.resource_subtype",
              "text",
              "type"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "anchor_gid",
                  "assignee",
                  "assignee.name",
                  "comment_gid",
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "custom_field",
                  "custom_field.date_value",
                  "custom_field.date_value.date",
                  "custom_field.date_value.date_time",
                  "custom_field.display_value",
                  "custom_field.enabled",
                  "custom_field.enum_options",
                  "custom_field.enum_options.color",
                  "custom_field.enum_options.enabled",
                  "custom_field.enum_options.name",
                  "custom_field.enum_value",
                  "custom_field.enum_value.color",
                  "custom_field.enum_value.enabled",
                  "custom_field.enum_value.name",
                  "custom_field.id_prefix",
                  "custom_field.input_restrictions",
                  "custom_field.is_formula_field",
                  "custom_field.is_lookup_field",
                  "custom_field.multi_enum_values",
                  "custom_field.multi_enum_values.color",
                  "custom_field.multi_enum_values.enabled",
                  "custom_field.multi_enum_values.name",
                  "custom_field.name",
                  "custom_field.number_value",
                  "custom_field.representation_type",
                  "custom_field.text_value",
                  "custom_field.type",
                  "dependency",
                  "dependency.created_by",
                  "dependency.name",
                  "dependency.resource_subtype",
                  "duplicate_of",
                  "duplicate_of.created_by",
                  "duplicate_of.name",
                  "duplicate_of.resource_subtype",
                  "duplicated_from",
                  "duplicated_from.created_by",
                  "duplicated_from.name",
                  "duplicated_from.resource_subtype",
                  "follower",
                  "follower.name",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_text",
                  "is_editable",
                  "is_edited",
                  "is_pinned",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "new_approval_status",
                  "new_date_value",
                  "new_dates",
                  "new_dates.due_at",
                  "new_dates.due_on",
                  "new_dates.start_on",
                  "new_enum_value",
                  "new_enum_value.color",
                  "new_enum_value.enabled",
                  "new_enum_value.name",
                  "new_multi_enum_values",
                  "new_multi_enum_values.color",
                  "new_multi_enum_values.enabled",
                  "new_multi_enum_values.name",
                  "new_name",
                  "new_number_value",
                  "new_people_value",
                  "new_people_value.name",
                  "new_resource_subtype",
                  "new_section",
                  "new_section.name",
                  "new_text_value",
                  "num_hearts",
                  "num_likes",
                  "old_approval_status",
                  "old_date_value",
                  "old_dates",
                  "old_dates.due_at",
                  "old_dates.due_on",
                  "old_dates.start_on",
                  "old_enum_value",
                  "old_enum_value.color",
                  "old_enum_value.enabled",
                  "old_enum_value.name",
                  "old_multi_enum_values",
                  "old_multi_enum_values.color",
                  "old_multi_enum_values.enabled",
                  "old_multi_enum_values.name",
                  "old_name",
                  "old_number_value",
                  "old_people_value",
                  "old_people_value.name",
                  "old_resource_subtype",
                  "old_section",
                  "old_section.name",
                  "old_text_value",
                  "previews",
                  "previews.fallback",
                  "previews.footer",
                  "previews.header",
                  "previews.header_link",
                  "previews.html_text",
                  "previews.text",
                  "previews.title",
                  "previews.title_link",
                  "project",
                  "project.name",
                  "project.resource_subtype",
                  "reaction_summary",
                  "reaction_summary.count",
                  "reaction_summary.emoji_base",
                  "reaction_summary.reacted",
                  "reaction_summary.variant",
                  "resource_subtype",
                  "source",
                  "sticker_name",
                  "story",
                  "story.anchor_gid",
                  "story.comment_gid",
                  "story.created_at",
                  "story.created_by",
                  "story.created_by.name",
                  "story.resource_subtype",
                  "story.text",
                  "tag",
                  "tag.name",
                  "target",
                  "target.created_by",
                  "target.name",
                  "target.resource_subtype",
                  "task",
                  "task.created_by",
                  "task.name",
                  "task.resource_subtype",
                  "text",
                  "type"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TaskStoryCreateRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The story to create.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/StoryResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__StoryResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created a new story."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "stories:write"
            ]
          }
        ],
        "summary": "Create a story on a task",
        "tags": [
          "Stories"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}~1stories/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nStory result = client.stories.createStoryForTask(taskGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet storiesApiInstance = new Asana.StoriesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The story to create.\nlet task_gid = \"321654\"; // String | The task to operate on.\nlet opts = { \n    'opt_fields': \"anchor_gid,assignee,assignee.name,comment_gid,created_at,created_by,created_by.name,custom_field,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_lookup_field,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.representation_type,custom_field.text_value,custom_field.type,dependency,dependency.created_by,dependency.name,dependency.resource_subtype,duplicate_of,duplicate_of.created_by,duplicate_of.name,duplicate_of.resource_subtype,duplicated_from,duplicated_from.created_by,duplicated_from.name,duplicated_from.resource_subtype,follower,follower.name,hearted,hearts,hearts.user,hearts.user.name,html_text,is_editable,is_edited,is_pinned,liked,likes,likes.user,likes.user.name,new_approval_status,new_date_value,new_dates,new_dates.due_at,new_dates.due_on,new_dates.start_on,new_enum_value,new_enum_value.color,new_enum_value.enabled,new_enum_value.name,new_multi_enum_values,new_multi_enum_values.color,new_multi_enum_values.enabled,new_multi_enum_values.name,new_name,new_number_value,new_people_value,new_people_value.name,new_resource_subtype,new_section,new_section.name,new_text_value,num_hearts,num_likes,old_approval_status,old_date_value,old_dates,old_dates.due_at,old_dates.due_on,old_dates.start_on,old_enum_value,old_enum_value.color,old_enum_value.enabled,old_enum_value.name,old_multi_enum_values,old_multi_enum_values.color,old_multi_enum_values.enabled,old_multi_enum_values.name,old_name,old_number_value,old_people_value,old_people_value.name,old_resource_subtype,old_section,old_section.name,old_text_value,previews,previews.fallback,previews.footer,previews.header,previews.header_link,previews.html_text,previews.text,previews.title,previews.title_link,project,project.name,project.resource_subtype,reaction_summary,reaction_summary.count,reaction_summary.emoji_base,reaction_summary.reacted,reaction_summary.variant,resource_subtype,source,sticker_name,story,story.anchor_gid,story.comment_gid,story.created_at,story.created_by,story.created_by.name,story.resource_subtype,story.text,tag,tag.name,target,target.created_by,target.name,target.resource_subtype,task,task.created_by,task.name,task.resource_subtype,text,type\"\n};\nstoriesApiInstance.createStoryForTask(body, task_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.stories.createStoryForTask(taskGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nstories_api_instance = asana.StoriesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The story to create.\ntask_gid = \"321654\" # str | The task to operate on.\nopts = {\n    'opt_fields': \"anchor_gid,assignee,assignee.name,comment_gid,created_at,created_by,created_by.name,custom_field,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_lookup_field,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.representation_type,custom_field.text_value,custom_field.type,dependency,dependency.created_by,dependency.name,dependency.resource_subtype,duplicate_of,duplicate_of.created_by,duplicate_of.name,duplicate_of.resource_subtype,duplicated_from,duplicated_from.created_by,duplicated_from.name,duplicated_from.resource_subtype,follower,follower.name,hearted,hearts,hearts.user,hearts.user.name,html_text,is_editable,is_edited,is_pinned,liked,likes,likes.user,likes.user.name,new_approval_status,new_date_value,new_dates,new_dates.due_at,new_dates.due_on,new_dates.start_on,new_enum_value,new_enum_value.color,new_enum_value.enabled,new_enum_value.name,new_multi_enum_values,new_multi_enum_values.color,new_multi_enum_values.enabled,new_multi_enum_values.name,new_name,new_number_value,new_people_value,new_people_value.name,new_resource_subtype,new_section,new_section.name,new_text_value,num_hearts,num_likes,old_approval_status,old_date_value,old_dates,old_dates.due_at,old_dates.due_on,old_dates.start_on,old_enum_value,old_enum_value.color,old_enum_value.enabled,old_enum_value.name,old_multi_enum_values,old_multi_enum_values.color,old_multi_enum_values.enabled,old_multi_enum_values.name,old_name,old_number_value,old_people_value,old_people_value.name,old_resource_subtype,old_section,old_section.name,old_text_value,previews,previews.fallback,previews.footer,previews.header,previews.header_link,previews.html_text,previews.text,previews.title,previews.title_link,project,project.name,project.resource_subtype,reaction_summary,reaction_summary.count,reaction_summary.emoji_base,reaction_summary.reacted,reaction_summary.variant,resource_subtype,source,sticker_name,story,story.anchor_gid,story.comment_gid,story.created_at,story.created_by,story.created_by.name,story.resource_subtype,story.text,tag,tag.name,target,target.created_by,target.name,target.resource_subtype,task,task.created_by,task.name,task.resource_subtype,text,type\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create a story on a task\n    api_response = stories_api_instance.create_story_for_task(body, task_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling StoriesApi->create_story_for_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.stories.create_story_for_task(task_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->stories->createStoryForTask($task_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.stories.create_story_for_task(task_gid: 'task_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/tasks/{task_gid}/subtasks": {
      "get": {
        "description": "<b>Required scope: </b><code>tasks:read</code>\n\nReturns a compact representation of all of the subtasks of a task.",
        "operationId": "getSubtasksForTask",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "actual_time_minutes",
              "approval_status",
              "assigned_by",
              "assigned_by.name",
              "assignee",
              "assignee.name",
              "assignee_section",
              "assignee_section.name",
              "assignee_status",
              "completed",
              "completed_at",
              "completed_by",
              "completed_by.name",
              "created_at",
              "created_by",
              "custom_fields",
              "custom_fields.asana_created_field",
              "custom_fields.created_by",
              "custom_fields.created_by.name",
              "custom_fields.currency_code",
              "custom_fields.custom_label",
              "custom_fields.custom_label_position",
              "custom_fields.date_value",
              "custom_fields.date_value.date",
              "custom_fields.date_value.date_time",
              "custom_fields.default_access_level",
              "custom_fields.description",
              "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.format",
              "custom_fields.has_notifications_enabled",
              "custom_fields.html_text_value",
              "custom_fields.id_prefix",
              "custom_fields.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_global_to_workspace",
              "custom_fields.is_lookup_field",
              "custom_fields.is_value_read_only",
              "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.people_value",
              "custom_fields.people_value.name",
              "custom_fields.precision",
              "custom_fields.privacy_setting",
              "custom_fields.reference_value",
              "custom_fields.reference_value.name",
              "custom_fields.representation_type",
              "custom_fields.resource_subtype",
              "custom_fields.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "custom_type_status_option",
              "custom_type_status_option.name",
              "dependencies",
              "dependents",
              "due_at",
              "due_on",
              "effective_memberships",
              "external",
              "external.data",
              "followers",
              "followers.name",
              "has_subtasks_date_mismatch",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_notes",
              "is_rendered_as_separator",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "memberships",
              "memberships.project",
              "memberships.project.name",
              "memberships.project.resource_subtype",
              "memberships.section",
              "memberships.section.name",
              "modified_at",
              "name",
              "notes",
              "num_hearts",
              "num_likes",
              "num_subtasks",
              "offset",
              "parent",
              "parent.created_by",
              "parent.name",
              "parent.resource_subtype",
              "path",
              "permalink_url",
              "projects",
              "projects.name",
              "projects.resource_subtype",
              "resource_subtype",
              "start_at",
              "start_on",
              "tags",
              "tags.name",
              "uri",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "actual_time_minutes",
                  "approval_status",
                  "assigned_by",
                  "assigned_by.name",
                  "assignee",
                  "assignee.name",
                  "assignee_section",
                  "assignee_section.name",
                  "assignee_status",
                  "completed",
                  "completed_at",
                  "completed_by",
                  "completed_by.name",
                  "created_at",
                  "created_by",
                  "custom_fields",
                  "custom_fields.asana_created_field",
                  "custom_fields.created_by",
                  "custom_fields.created_by.name",
                  "custom_fields.currency_code",
                  "custom_fields.custom_label",
                  "custom_fields.custom_label_position",
                  "custom_fields.date_value",
                  "custom_fields.date_value.date",
                  "custom_fields.date_value.date_time",
                  "custom_fields.default_access_level",
                  "custom_fields.description",
                  "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.format",
                  "custom_fields.has_notifications_enabled",
                  "custom_fields.html_text_value",
                  "custom_fields.id_prefix",
                  "custom_fields.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_global_to_workspace",
                  "custom_fields.is_lookup_field",
                  "custom_fields.is_value_read_only",
                  "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.people_value",
                  "custom_fields.people_value.name",
                  "custom_fields.precision",
                  "custom_fields.privacy_setting",
                  "custom_fields.reference_value",
                  "custom_fields.reference_value.name",
                  "custom_fields.representation_type",
                  "custom_fields.resource_subtype",
                  "custom_fields.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "custom_type_status_option",
                  "custom_type_status_option.name",
                  "dependencies",
                  "dependents",
                  "due_at",
                  "due_on",
                  "effective_memberships",
                  "external",
                  "external.data",
                  "followers",
                  "followers.name",
                  "has_subtasks_date_mismatch",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_notes",
                  "is_rendered_as_separator",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "memberships",
                  "memberships.project",
                  "memberships.project.name",
                  "memberships.project.resource_subtype",
                  "memberships.section",
                  "memberships.section.name",
                  "modified_at",
                  "name",
                  "notes",
                  "num_hearts",
                  "num_likes",
                  "num_subtasks",
                  "offset",
                  "parent",
                  "parent.created_by",
                  "parent.name",
                  "parent.resource_subtype",
                  "path",
                  "permalink_url",
                  "projects",
                  "projects.name",
                  "projects.resource_subtype",
                  "resource_subtype",
                  "start_at",
                  "start_on",
                  "tags",
                  "tags.name",
                  "uri",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TaskCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TaskResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the specified task's subtasks."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:read"
            ]
          }
        ],
        "summary": "Get subtasks from a task",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}~1subtasks/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Task> result = client.tasks.getSubtasksForTask(taskGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet task_gid = \"321654\"; // String | The task to operate on.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,offset,parent,parent.created_by,parent.name,parent.resource_subtype,path,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,uri,workspace,workspace.name\"\n};\ntasksApiInstance.getSubtasksForTask(task_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.getSubtasksForTask(taskGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\ntask_gid = \"321654\" # str | The task to operate on.\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    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,offset,parent,parent.created_by,parent.name,parent.resource_subtype,path,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,uri,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get subtasks from a task\n    api_response = tasks_api_instance.get_subtasks_for_task(task_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->get_subtasks_for_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.get_subtasks_for_task(task_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->getSubtasksForTask($task_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.get_subtasks_for_task(task_gid: 'task_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/task_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>tasks:write</code>\n\nCreates a new subtask and adds it to the parent task. Returns the full record for the newly created subtask.",
        "operationId": "createSubtaskForTask",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "actual_time_minutes",
              "approval_status",
              "assigned_by",
              "assigned_by.name",
              "assignee",
              "assignee.name",
              "assignee_section",
              "assignee_section.name",
              "assignee_status",
              "completed",
              "completed_at",
              "completed_by",
              "completed_by.name",
              "created_at",
              "created_by",
              "custom_fields",
              "custom_fields.asana_created_field",
              "custom_fields.created_by",
              "custom_fields.created_by.name",
              "custom_fields.currency_code",
              "custom_fields.custom_label",
              "custom_fields.custom_label_position",
              "custom_fields.date_value",
              "custom_fields.date_value.date",
              "custom_fields.date_value.date_time",
              "custom_fields.default_access_level",
              "custom_fields.description",
              "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.format",
              "custom_fields.has_notifications_enabled",
              "custom_fields.html_text_value",
              "custom_fields.id_prefix",
              "custom_fields.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_global_to_workspace",
              "custom_fields.is_lookup_field",
              "custom_fields.is_value_read_only",
              "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.people_value",
              "custom_fields.people_value.name",
              "custom_fields.precision",
              "custom_fields.privacy_setting",
              "custom_fields.reference_value",
              "custom_fields.reference_value.name",
              "custom_fields.representation_type",
              "custom_fields.resource_subtype",
              "custom_fields.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "custom_type_status_option",
              "custom_type_status_option.name",
              "dependencies",
              "dependents",
              "due_at",
              "due_on",
              "effective_memberships",
              "external",
              "external.data",
              "followers",
              "followers.name",
              "has_subtasks_date_mismatch",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_notes",
              "is_rendered_as_separator",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "memberships",
              "memberships.project",
              "memberships.project.name",
              "memberships.project.resource_subtype",
              "memberships.section",
              "memberships.section.name",
              "modified_at",
              "name",
              "notes",
              "num_hearts",
              "num_likes",
              "num_subtasks",
              "parent",
              "parent.created_by",
              "parent.name",
              "parent.resource_subtype",
              "permalink_url",
              "projects",
              "projects.name",
              "projects.resource_subtype",
              "resource_subtype",
              "start_at",
              "start_on",
              "tags",
              "tags.name",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "actual_time_minutes",
                  "approval_status",
                  "assigned_by",
                  "assigned_by.name",
                  "assignee",
                  "assignee.name",
                  "assignee_section",
                  "assignee_section.name",
                  "assignee_status",
                  "completed",
                  "completed_at",
                  "completed_by",
                  "completed_by.name",
                  "created_at",
                  "created_by",
                  "custom_fields",
                  "custom_fields.asana_created_field",
                  "custom_fields.created_by",
                  "custom_fields.created_by.name",
                  "custom_fields.currency_code",
                  "custom_fields.custom_label",
                  "custom_fields.custom_label_position",
                  "custom_fields.date_value",
                  "custom_fields.date_value.date",
                  "custom_fields.date_value.date_time",
                  "custom_fields.default_access_level",
                  "custom_fields.description",
                  "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.format",
                  "custom_fields.has_notifications_enabled",
                  "custom_fields.html_text_value",
                  "custom_fields.id_prefix",
                  "custom_fields.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_global_to_workspace",
                  "custom_fields.is_lookup_field",
                  "custom_fields.is_value_read_only",
                  "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.people_value",
                  "custom_fields.people_value.name",
                  "custom_fields.precision",
                  "custom_fields.privacy_setting",
                  "custom_fields.reference_value",
                  "custom_fields.reference_value.name",
                  "custom_fields.representation_type",
                  "custom_fields.resource_subtype",
                  "custom_fields.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "custom_type_status_option",
                  "custom_type_status_option.name",
                  "dependencies",
                  "dependents",
                  "due_at",
                  "due_on",
                  "effective_memberships",
                  "external",
                  "external.data",
                  "followers",
                  "followers.name",
                  "has_subtasks_date_mismatch",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_notes",
                  "is_rendered_as_separator",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "memberships",
                  "memberships.project",
                  "memberships.project.name",
                  "memberships.project.resource_subtype",
                  "memberships.section",
                  "memberships.section.name",
                  "modified_at",
                  "name",
                  "notes",
                  "num_hearts",
                  "num_likes",
                  "num_subtasks",
                  "parent",
                  "parent.created_by",
                  "parent.name",
                  "parent.resource_subtype",
                  "permalink_url",
                  "projects",
                  "projects.name",
                  "projects.resource_subtype",
                  "resource_subtype",
                  "start_at",
                  "start_on",
                  "tags",
                  "tags.name",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "allOf": [
                      {
                        "allOf": [
                          {
                            "allOf": [
                              {
                                "description": "The *task* is the basic object around which many operations in Asana are centered.",
                                "properties": {
                                  "created_by": {
                                    "description": "[Opt In](/docs/inputoutput-options). A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.",
                                    "properties": {
                                      "gid": {
                                        "description": "Globally unique identifier of the resource.",
                                        "example": "1111",
                                        "type": "string"
                                      },
                                      "resource_type": {
                                        "description": "The type of resource.",
                                        "example": "user",
                                        "type": "string"
                                      }
                                    },
                                    "readOnly": true,
                                    "type": "object"
                                  },
                                  "gid": {
                                    "description": "Globally unique identifier of the resource, as a string.",
                                    "example": "12345",
                                    "readOnly": true,
                                    "type": "string",
                                    "x-insert-after": false
                                  },
                                  "name": {
                                    "description": "The name of the task.",
                                    "example": "Bug Task",
                                    "type": "string"
                                  },
                                  "resource_subtype": {
                                    "description": "The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\nThe resource_subtype `milestone` represent a single moment in time. This means tasks with this subtype cannot have a start_date.",
                                    "enum": [
                                      "default_task",
                                      "milestone",
                                      "approval",
                                      "custom"
                                    ],
                                    "example": "default_task",
                                    "type": "string"
                                  },
                                  "resource_type": {
                                    "description": "The base type of this resource.",
                                    "example": "task",
                                    "readOnly": true,
                                    "type": "string",
                                    "x-insert-after": "gid"
                                  }
                                },
                                "type": "object"
                              },
                              {
                                "properties": {
                                  "actual_time_minutes": {
                                    "description": "<p><strong style={{ color: \"#4573D2\" }}>Full object requires scope: </strong><code>time_tracking_entries:read</code></p>\n\nThis value represents the sum of all the Time Tracking entries in the Actual Time field on a given Task. It is represented as a nullable long value.",
                                    "example": 200,
                                    "nullable": true,
                                    "readOnly": true,
                                    "type": "number"
                                  },
                                  "approval_status": {
                                    "description": "*Conditional* Reflects the approval status of this task. This field is kept in sync with `completed`, meaning `pending` translates to false while `approved`, `rejected`, and `changes_requested` translate to true. If you set completed to true, this field will be set to `approved`.",
                                    "enum": [
                                      "pending",
                                      "approved",
                                      "rejected",
                                      "changes_requested"
                                    ],
                                    "example": "pending",
                                    "type": "string"
                                  },
                                  "assigned_by": {
                                    "allOf": [
                                      {
                                        "$ref": "#/components/schemas/UserCompact"
                                      },
                                      {
                                        "description": "The user who assigned the task. This field is only returned when requesting it via opt_fields, and will be null if the task has no specific assigner (e.g., tasks created without an explicit assigner).",
                                        "readOnly": true
                                      }
                                    ],
                                    "nullable": true
                                  },
                                  "assignee_status": {
                                    "description": "*Deprecated* Scheduling status of this task for the user it is assigned to. This field can only be set if the assignee is non-null. Setting this field to \"inbox\" or \"upcoming\" inserts it at the top of the section, while the other options will insert at the bottom.",
                                    "enum": [
                                      "today",
                                      "upcoming",
                                      "later",
                                      "new",
                                      "inbox"
                                    ],
                                    "example": "upcoming",
                                    "type": "string"
                                  },
                                  "completed": {
                                    "description": "True if the task is currently marked complete, false if not.",
                                    "example": false,
                                    "type": "boolean"
                                  },
                                  "completed_at": {
                                    "description": "The time at which this task was completed, or null if the task is incomplete.",
                                    "example": "2012-02-22T02:06:58.147Z",
                                    "format": "date-time",
                                    "nullable": true,
                                    "readOnly": true,
                                    "type": "string"
                                  },
                                  "completed_by": {
                                    "allOf": [
                                      {
                                        "$ref": "#/components/schemas/UserCompact"
                                      },
                                      {
                                        "readOnly": true
                                      }
                                    ],
                                    "nullable": true
                                  },
                                  "created_at": {
                                    "description": "The time at which this resource was created.",
                                    "example": "2012-02-22T02:06:58.147Z",
                                    "format": "date-time",
                                    "readOnly": true,
                                    "type": "string"
                                  },
                                  "dependencies": {
                                    "description": "[Opt In](/docs/inputoutput-options). Array of resources referencing tasks that this task depends on. The objects contain only the gid of the dependency.",
                                    "items": {
                                      "$ref": "#/components/schemas/AsanaResource"
                                    },
                                    "readOnly": true,
                                    "type": "array"
                                  },
                                  "dependents": {
                                    "description": "[Opt In](/docs/inputoutput-options). Array of resources referencing tasks that depend on this task. The objects contain only the ID of the dependent.",
                                    "items": {
                                      "$ref": "#/components/schemas/AsanaResource"
                                    },
                                    "readOnly": true,
                                    "type": "array"
                                  },
                                  "due_at": {
                                    "description": "The UTC date and time on which this task is due, or null if the task has no due time. This takes an ISO 8601 date string in UTC and should not be used together with `due_on`.",
                                    "example": "2019-09-15T02:06:58.147Z",
                                    "format": "date-time",
                                    "nullable": true,
                                    "type": "string"
                                  },
                                  "due_on": {
                                    "description": "The localized date on which this task is due, or null if the task has no due date. This takes a date with `YYYY-MM-DD` format and should not be used together with `due_at`.",
                                    "example": "2019-09-15",
                                    "format": "date",
                                    "nullable": true,
                                    "type": "string"
                                  },
                                  "external": {
                                    "description": "*OAuth Required*. *Conditional*. This field is returned only if external values are set or included by using [Opt In](/docs/inputoutput-options).\nThe external field allows you to store app-specific metadata on tasks, including a gid that can be used to retrieve tasks and a data blob that can store app-specific character strings. Note that you will need to authenticate with Oauth to access or modify this data. Once an external gid is set, you can use the notation `external:custom_gid` to reference your object anywhere in the API where you may use the original object gid. See the page on Custom External Data for more details.",
                                    "example": {
                                      "data": "A blob of information",
                                      "gid": "my_gid"
                                    },
                                    "properties": {
                                      "data": {
                                        "example": "A blob of information.",
                                        "type": "string"
                                      },
                                      "gid": {
                                        "example": "1234",
                                        "type": "string"
                                      }
                                    },
                                    "type": "object"
                                  },
                                  "has_subtasks_date_mismatch": {
                                    "description": "[Opt In](/docs/inputoutput-options). True when one or more descendant subtasks have dates outside the task's own date range. This field reflects the latest computed rollup state and returns false when no rollup has been computed.",
                                    "example": true,
                                    "readOnly": true,
                                    "type": "boolean"
                                  },
                                  "hearted": {
                                    "description": "*Deprecated - please use liked instead* True if the task is hearted by the authorized user, false if not.",
                                    "example": true,
                                    "readOnly": true,
                                    "type": "boolean"
                                  },
                                  "hearts": {
                                    "description": "*Deprecated - please use likes instead* Array of likes for users who have hearted this task.",
                                    "items": {
                                      "$ref": "#/components/schemas/Like"
                                    },
                                    "readOnly": true,
                                    "type": "array"
                                  },
                                  "html_notes": {
                                    "description": "[Opt In](/docs/inputoutput-options). The notes of the text with formatting as HTML. See [rich text](/docs/rich-text).",
                                    "example": "<body>Mittens <em>really</em> likes the stuff from Humboldt.</body>",
                                    "type": "string"
                                  },
                                  "is_rendered_as_separator": {
                                    "description": "[Opt In](/docs/inputoutput-options). In some contexts tasks can be rendered as a visual separator; for instance, subtasks can appear similar to [sections](/reference/sections) without being true `section` objects. If a `task` object is rendered this way in any context it will have the property `is_rendered_as_separator` set to `true`. This parameter only applies to regular tasks with `resource_subtype` of `default_task`. Tasks with `resource_subtype` of `milestone`, `approval`, or custom task types will not have this property and cannot be rendered as separators.",
                                    "example": false,
                                    "readOnly": true,
                                    "type": "boolean"
                                  },
                                  "liked": {
                                    "description": "True if the task is liked by the authorized user, false if not.",
                                    "example": true,
                                    "type": "boolean"
                                  },
                                  "likes": {
                                    "description": "Array of likes for users who have liked this task.",
                                    "items": {
                                      "$ref": "#/components/schemas/Like"
                                    },
                                    "readOnly": true,
                                    "type": "array"
                                  },
                                  "memberships": {
                                    "description": "Create-only project and section membership IDs.",
                                    "items": {
                                      "properties": {
                                        "project": {
                                          "type": "string"
                                        },
                                        "section": {
                                          "nullable": true,
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "project"
                                      ],
                                      "type": "object"
                                    },
                                    "type": "array"
                                  },
                                  "modified_at": {
                                    "description": "The time at which this task was last modified.\n\nThe following conditions will change `modified_at`:\n\n- story is created on a task\n- story is trashed on a task\n- attachment is trashed on a task\n- task is assigned or unassigned\n- custom field value is changed\n- the task itself is trashed\n- Or if any of the following fields are updated:\n  - completed\n  - name\n  - due_date\n  - description\n  - attachments\n  - items\n  - schedule_status\n\nThe following conditions will _not_ change `modified_at`:\n\n- moving to a new container (project, portfolio, etc)\n- comments being added to the task (but the stories they generate\n  _will_ affect `modified_at`)",
                                    "example": "2012-02-22T02:06:58.147Z",
                                    "format": "date-time",
                                    "readOnly": true,
                                    "type": "string"
                                  },
                                  "name": {
                                    "description": "Name of the task. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.",
                                    "example": "Buy catnip",
                                    "type": "string"
                                  },
                                  "notes": {
                                    "description": "Free-form textual information associated with the task (i.e. its description).",
                                    "example": "Mittens really likes the stuff from Humboldt.",
                                    "type": "string"
                                  },
                                  "num_hearts": {
                                    "description": "*Deprecated - please use likes instead* The number of users who have hearted this task.",
                                    "example": 5,
                                    "readOnly": true,
                                    "type": "integer"
                                  },
                                  "num_likes": {
                                    "description": "The number of users who have liked this task.",
                                    "example": 5,
                                    "readOnly": true,
                                    "type": "integer"
                                  },
                                  "num_subtasks": {
                                    "description": "[Opt In](/docs/inputoutput-options). The number of subtasks on this task.\n",
                                    "example": 3,
                                    "readOnly": true,
                                    "type": "integer"
                                  },
                                  "start_at": {
                                    "description": "Date and time on which work begins for the task, or null if the task has no start time. This takes an ISO 8601 date string in UTC and should not be used together with `start_on`.\n*Note: `due_at` must be present in the request when setting or unsetting the `start_at` parameter.*",
                                    "example": "2019-09-14T02:06:58.147Z",
                                    "format": "date-time",
                                    "nullable": true,
                                    "type": "string"
                                  },
                                  "start_on": {
                                    "description": "The day on which work begins for the task , or null if the task has no start date. This takes a date with `YYYY-MM-DD` format and should not be used together with `start_at`.\n*Note: `due_on` or `due_at` must be present in the request when setting or unsetting the `start_on` parameter.*",
                                    "example": "2019-09-14",
                                    "format": "date",
                                    "nullable": true,
                                    "type": "string"
                                  }
                                },
                                "type": "object"
                              }
                            ]
                          },
                          {
                            "properties": {
                              "assignee": {
                                "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
                                "example": "12345",
                                "nullable": true,
                                "readOnly": false,
                                "type": "string",
                                "x-env-variable": true
                              },
                              "assignee_section": {
                                "description": "The *assignee section* is a subdivision of a project that groups tasks together in the assignee's \"My tasks\" list. It can either be a header above a list of tasks in a list view or a column in a board view of \"My tasks.\"\nThe `assignee_section` property will be returned in the response only if the request was sent by the user who is the assignee of the task. Note that you can only write to `assignee_section` with the gid of an existing section visible in the user's \"My tasks\" list.",
                                "example": "12345",
                                "nullable": true,
                                "type": "string"
                              },
                              "custom_fields": {
                                "additionalProperties": {
                                  "description": "\"{custom_field_gid}\" => Value (can be text, a number, etc.). For date, use format \"YYYY-MM-DD\" (e.g., 2019-09-15). For date-time, use ISO 8601 date string in UTC (e.g., 2019-09-15T02:06:58.147Z).",
                                  "type": "string"
                                },
                                "description": "An object where each key is the GID of a custom field and its corresponding value is either an enum GID, string, number, object, or array (depending on the custom field type). See the [custom fields guide](/docs/custom-fields-guide) for details on creating and updating custom field values.",
                                "example": {
                                  "4578152156": "Not Started",
                                  "5678904321": "On Hold"
                                },
                                "type": "object"
                              },
                              "custom_type": {
                                "description": "*Conditional:* You can only set custom_type if task `resource_subtype` is `custom`. GID or globally-unique identifier of a task's custom type. The type must be valid for tasks, and some Asana-created custom types cannot be assigned via the API; attempting either returns an error explaining which condition failed.",
                                "example": "12345",
                                "nullable": true,
                                "readOnly": false,
                                "type": "string",
                                "x-env-variable": true
                              },
                              "custom_type_status_option": {
                                "description": "*Conditional:* You can only set custom_type_status_option if task `resource_subtype` is `custom` GID or globally-unique identifier of a custom type's status option.",
                                "example": "12345",
                                "nullable": true,
                                "readOnly": false,
                                "type": "string",
                                "x-env-variable": true
                              },
                              "html_custom_fields": {
                                "additionalProperties": {
                                  "description": "\"{custom_field_gid}\" => HTML string (e.g., \"<body>Text content</body>\")",
                                  "type": "string"
                                },
                                "description": "An object where each key is the GID of a text custom field and the corresponding value is a rich text HTML string. Only text-type custom fields support this parameter. Values must be wrapped in <body></body> tags. See the [custom fields guide](/docs/custom-fields-guide) and [rich text](/docs/rich-text) for details on supported formatting.",
                                "example": {
                                  "4578152156": "<body><code>Code block</code></body>",
                                  "5678904321": "<body><strong>Bold text</strong></body>"
                                },
                                "type": "object"
                              },
                              "parent": {
                                "description": "Gid of a task.",
                                "example": "12345",
                                "nullable": true,
                                "readOnly": false,
                                "type": "string",
                                "x-env-variable": true
                              }
                            },
                            "type": "object"
                          }
                        ]
                      },
                      {
                        "properties": {
                          "followers": {
                            "description": "*Create-Only* An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user. In order to change followers on an existing task use `addFollowers` and `removeFollowers`.",
                            "example": [
                              "12345"
                            ],
                            "items": {
                              "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.",
                              "type": "string"
                            },
                            "type": "array"
                          },
                          "projects": {
                            "description": "*Create-Only* Array of project gids. In order to change projects on an existing task use `addProject` and `removeProject`.",
                            "example": [
                              "12345"
                            ],
                            "items": {
                              "description": "Gid of a project.",
                              "type": "string"
                            },
                            "type": "array"
                          },
                          "tags": {
                            "description": "*Create-Only* Array of tag gids. In order to change tags on an existing task use `addTag` and `removeTag`.",
                            "example": [
                              "12345"
                            ],
                            "items": {
                              "description": "Gid of a tag.",
                              "type": "string"
                            },
                            "type": "array"
                          },
                          "workspace": {
                            "description": "Gid of a workspace.",
                            "example": "12345",
                            "readOnly": false,
                            "type": "string",
                            "x-env-variable": true
                          }
                        },
                        "type": "object"
                      }
                    ]
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The new subtask to create.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TaskResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TaskResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created the specified subtask."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:write"
            ]
          }
        ],
        "summary": "Create a subtask",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}~1subtasks/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nTask result = client.tasks.createSubtaskForTask(taskGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The new subtask to create.\nlet task_gid = \"321654\"; // String | The task to operate on.\nlet opts = { \n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,parent,parent.created_by,parent.name,parent.resource_subtype,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,workspace,workspace.name\"\n};\ntasksApiInstance.createSubtaskForTask(body, task_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.createSubtaskForTask(taskGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The new subtask to create.\ntask_gid = \"321654\" # str | The task to operate on.\nopts = {\n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,parent,parent.created_by,parent.name,parent.resource_subtype,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create a subtask\n    api_response = tasks_api_instance.create_subtask_for_task(body, task_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->create_subtask_for_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.create_subtask_for_task(task_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->createSubtaskForTask($task_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.create_subtask_for_task(task_gid: 'task_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/tasks/{task_gid}/tags": {
      "get": {
        "description": "<b>Required scope: </b><code>tags:read</code>\n\nGet a compact representation of all of the tags the task has.",
        "operationId": "getTagsForTask",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "color",
              "created_at",
              "followers",
              "followers.name",
              "name",
              "notes",
              "offset",
              "path",
              "permalink_url",
              "uri",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "color",
                  "created_at",
                  "followers",
                  "followers.name",
                  "name",
                  "notes",
                  "offset",
                  "path",
                  "permalink_url",
                  "uri",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TagCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TagResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the tags for the given task."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tags:read"
            ]
          }
        ],
        "summary": "Get a task's tags",
        "tags": [
          "Tags"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}~1tags/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Tag> result = client.tags.getTagsForTask(taskGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tagsApiInstance = new Asana.TagsApi(client);\nlet task_gid = \"321654\"; // String | The task to operate on.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"color,created_at,followers,followers.name,name,notes,offset,path,permalink_url,uri,workspace,workspace.name\"\n};\ntagsApiInstance.getTagsForTask(task_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tags.getTagsForTask(taskGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntags_api_instance = asana.TagsApi(api_client)\ntask_gid = \"321654\" # str | The task to operate on.\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    'opt_fields': \"color,created_at,followers,followers.name,name,notes,offset,path,permalink_url,uri,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a task's tags\n    api_response = tags_api_instance.get_tags_for_task(task_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TagsApi->get_tags_for_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tags.get_tags_for_task(task_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tags->getTagsForTask($task_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tags.get_tags_for_task(task_gid: 'task_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/task_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/tasks/{task_gid}/time_tracking_entries": {
      "get": {
        "description": "<b>Required scope: </b><code>time_tracking_entries:read</code>\n\nReturns time tracking entries for a given task.",
        "operationId": "getTimeTrackingEntriesForTask",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "assignee",
              "assignee.name",
              "attributable_to",
              "attributable_to.name",
              "attributable_to.resource_subtype",
              "categories",
              "categories.color",
              "categories.name",
              "created_by",
              "created_by.name",
              "duration_minutes",
              "entered_on",
              "offset",
              "path",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "assignee",
                  "assignee.name",
                  "attributable_to",
                  "attributable_to.name",
                  "attributable_to.resource_subtype",
                  "categories",
                  "categories.color",
                  "categories.name",
                  "created_by",
                  "created_by.name",
                  "duration_minutes",
                  "entered_on",
                  "offset",
                  "path",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TimeTrackingEntryCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TimeTrackingEntryCompactArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested time tracking entries."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "time_tracking_entries:read"
            ]
          }
        ],
        "summary": "Get time tracking entries for a task",
        "tags": [
          "Time tracking entries"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}~1time_tracking_entries/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet timeTrackingEntriesApiInstance = new Asana.TimeTrackingEntriesApi(client);\nlet task_gid = \"321654\"; // String | The task to operate on.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"assignee,assignee.name,attributable_to,attributable_to.name,attributable_to.resource_subtype,categories,categories.color,categories.name,created_by,created_by.name,duration_minutes,entered_on,offset,path,uri\"\n};\ntimeTrackingEntriesApiInstance.getTimeTrackingEntriesForTask(task_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.timetrackingentries.getTimeTrackingEntriesForTask(taskGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntime_tracking_entries_api_instance = asana.TimeTrackingEntriesApi(api_client)\ntask_gid = \"321654\" # str | The task to operate on.\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    'opt_fields': \"assignee,assignee.name,attributable_to,attributable_to.name,attributable_to.resource_subtype,categories,categories.color,categories.name,created_by,created_by.name,duration_minutes,entered_on,offset,path,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get time tracking entries for a task\n    api_response = time_tracking_entries_api_instance.get_time_tracking_entries_for_task(task_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TimeTrackingEntriesApi->get_time_tracking_entries_for_task: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.time_tracking_entries.get_time_tracking_entries_for_task(task_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/task_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "Creates a time tracking entry on a given task.\n\nReturns the record of the newly created time tracking entry.\n\n#### Access requirements\n\nAccess to this endpoint has two levels:\n\n- **Endpoint access** requires time tracking to be available through the domain's plan\nor add-ons. A request from a domain without time tracking access returns a\n`402 Payment Required` error for every request to this endpoint.\n\n- **Field access** for some request fields requires the Timesheets and Budgets add-on.\nFields with this requirement are noted in the request schema. Including one of these\nfields without the add-on returns a `402 Payment Required` error, even when the rest of\nthe request is valid.\n\nBecause the field-level requirement is separate, the same endpoint may return `201` or\n`402` for the same domain depending on which fields are sent: a request that only uses\nfields available with endpoint access succeeds on any domain that meets the endpoint\nrequirement, while a request that includes a field requiring the add-on also requires\nthe add-on.",
        "operationId": "createTimeTrackingEntry",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "approval_status",
              "assignee",
              "assignee.name",
              "attributable_to",
              "attributable_to.name",
              "attributable_to.resource_subtype",
              "billable_status",
              "categories",
              "categories.color",
              "categories.name",
              "created_at",
              "created_by",
              "created_by.name",
              "description",
              "duration_minutes",
              "entered_on",
              "task",
              "task.created_by",
              "task.name",
              "task.resource_subtype"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "approval_status",
                  "assignee",
                  "assignee.name",
                  "attributable_to",
                  "attributable_to.name",
                  "attributable_to.resource_subtype",
                  "billable_status",
                  "categories",
                  "categories.color",
                  "categories.name",
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "description",
                  "duration_minutes",
                  "entered_on",
                  "task",
                  "task.created_by",
                  "task.name",
                  "task.resource_subtype"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/CreateTimeTrackingEntryRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Information about the time tracking entry.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TimeTrackingEntryBase"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TimeTrackingEntryBaseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created a time tracking entry for the task."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Create a time tracking entry",
        "tags": [
          "Time tracking entries"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1tasks~1{task_gid}~1time_tracking_entries/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet timeTrackingEntriesApiInstance = new Asana.TimeTrackingEntriesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | Information about the time tracking entry.\nlet task_gid = \"321654\"; // String | The task to operate on.\nlet opts = { \n    'opt_fields': \"approval_status,assignee,assignee.name,attributable_to,attributable_to.name,attributable_to.resource_subtype,billable_status,categories,categories.color,categories.name,created_at,created_by,created_by.name,description,duration_minutes,entered_on,task,task.created_by,task.name,task.resource_subtype\"\n};\ntimeTrackingEntriesApiInstance.createTimeTrackingEntry(body, task_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.timetrackingentries.createTimeTrackingEntry(taskGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntime_tracking_entries_api_instance = asana.TimeTrackingEntriesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | Information about the time tracking entry.\ntask_gid = \"321654\" # str | The task to operate on.\nopts = {\n    'opt_fields': \"approval_status,assignee,assignee.name,attributable_to,attributable_to.name,attributable_to.resource_subtype,billable_status,categories,categories.color,categories.name,created_at,created_by,created_by.name,description,duration_minutes,entered_on,task,task.created_by,task.name,task.resource_subtype\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create a time tracking entry\n    api_response = time_tracking_entries_api_instance.create_time_tracking_entry(body, task_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TimeTrackingEntriesApi->create_time_tracking_entry: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.time_tracking_entries.create_time_tracking_entry(task_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            }
          ]
        }
      }
    },
    "/team_memberships": {
      "get": {
        "description": "<b>Required scope: </b><code>team_memberships:read</code>\n\nReturns compact team membership records.",
        "operationId": "getTeamMemberships",
        "parameters": [
          {
            "description": "Globally unique identifier for the team.",
            "example": "159874",
            "in": "query",
            "name": "team",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "A string identifying a user. This can either be the string \"me\", an email, or the gid of a user. This parameter must be used with the workspace parameter.",
            "example": "512241",
            "in": "query",
            "name": "user",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Globally unique identifier for the workspace. This parameter must be used with the user parameter.",
            "example": "31326",
            "in": "query",
            "name": "workspace",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "is_admin",
              "is_guest",
              "is_limited_access",
              "offset",
              "path",
              "team",
              "team.name",
              "uri",
              "user",
              "user.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "is_admin",
                  "is_guest",
                  "is_limited_access",
                  "offset",
                  "path",
                  "team",
                  "team.name",
                  "uri",
                  "user",
                  "user.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TeamMembershipCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TeamMembershipResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested team memberships."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "team_memberships:read"
            ]
          }
        ],
        "summary": "Get team memberships",
        "tags": [
          "Team memberships"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1team_memberships/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<JsonElement> result = client.teammemberships.getTeamMemberships(workspace, user, team)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet teamMembershipsApiInstance = new Asana.TeamMembershipsApi(client);\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'team': \"159874\", \n    'user': \"512241\", \n    'workspace': \"31326\", \n    'opt_fields': \"is_admin,is_guest,is_limited_access,offset,path,team,team.name,uri,user,user.name\"\n};\nteamMembershipsApiInstance.getTeamMemberships(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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.teammemberships.getTeamMemberships({param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nteam_memberships_api_instance = asana.TeamMembershipsApi(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    'team': \"159874\", # str | Globally unique identifier for the team.\n    'user': \"512241\", # str | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user. This parameter must be used with the workspace parameter.\n    'workspace': \"31326\", # str | Globally unique identifier for the workspace. This parameter must be used with the user parameter.\n    'opt_fields': \"is_admin,is_guest,is_limited_access,offset,path,team,team.name,uri,user,user.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get team memberships\n    api_response = team_memberships_api_instance.get_team_memberships(opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TeamMembershipsApi->get_team_memberships: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.team_memberships.get_team_memberships({'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->teammemberships->getTeamMemberships(array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.team_memberships.get_team_memberships(param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/team_memberships/{team_membership_gid}": {
      "get": {
        "description": "<b>Required scope: </b><code>team_memberships:read</code>\n\n<table>\n  <tr>\n    <th>Field</th>\n    <th>Required Scope</th>\n  </tr>\n  <tr>\n    <td><code>team</code></td>\n    <td><code>teams:read</code></td>\n  </tr>\n</table>\n\nReturns the complete team membership record for a single team membership.",
        "operationId": "getTeamMembership",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "is_admin",
              "is_guest",
              "is_limited_access",
              "team",
              "team.name",
              "user",
              "user.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "is_admin",
                  "is_guest",
                  "is_limited_access",
                  "team",
                  "team.name",
                  "user",
                  "user.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TeamMembershipResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TeamMembershipResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested team membership."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "team_memberships:read"
            ]
          }
        ],
        "summary": "Get a team membership",
        "tags": [
          "Team memberships"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1team_memberships~1{team_membership_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.teammemberships.getTeamMembership(teamMembershipGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet teamMembershipsApiInstance = new Asana.TeamMembershipsApi(client);\nlet team_membership_gid = \"724362\"; // String | \nlet opts = { \n    'opt_fields': \"is_admin,is_guest,is_limited_access,team,team.name,user,user.name\"\n};\nteamMembershipsApiInstance.getTeamMembership(team_membership_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.teammemberships.getTeamMembership(teamMembershipGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nteam_memberships_api_instance = asana.TeamMembershipsApi(api_client)\nteam_membership_gid = \"724362\" # str | \nopts = {\n    'opt_fields': \"is_admin,is_guest,is_limited_access,team,team.name,user,user.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a team membership\n    api_response = team_memberships_api_instance.get_team_membership(team_membership_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TeamMembershipsApi->get_team_membership: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.team_memberships.get_team_membership(team_membership_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->teammemberships->getTeamMembership($team_membership_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.team_memberships.get_team_membership(team_membership_gid: 'team_membership_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/team_membership_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/teams": {
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/teams/{team_gid}": {
      "get": {
        "description": "<b>Required scope: </b><code>teams:read</code>\n\nReturns the full record for a single team.",
        "operationId": "getTeam",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "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.default_access_level",
              "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.html_text_value",
              "custom_field_settings.custom_field.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_global_to_workspace",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.privacy_setting",
              "custom_field_settings.custom_field.reference_value",
              "custom_field_settings.custom_field.reference_value.name",
              "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.parent.resource_subtype",
              "custom_field_settings.project",
              "custom_field_settings.project.name",
              "custom_field_settings.project.resource_subtype",
              "description",
              "edit_team_name_or_description_access_level",
              "edit_team_visibility_or_trash_team_access_level",
              "endorsed",
              "guest_invite_management_access_level",
              "html_description",
              "join_request_management_access_level",
              "member_invite_management_access_level",
              "name",
              "organization",
              "organization.name",
              "permalink_url",
              "team_content_management_access_level",
              "team_member_removal_access_level",
              "visibility"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "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.default_access_level",
                  "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.html_text_value",
                  "custom_field_settings.custom_field.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_global_to_workspace",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.privacy_setting",
                  "custom_field_settings.custom_field.reference_value",
                  "custom_field_settings.custom_field.reference_value.name",
                  "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.parent.resource_subtype",
                  "custom_field_settings.project",
                  "custom_field_settings.project.name",
                  "custom_field_settings.project.resource_subtype",
                  "description",
                  "edit_team_name_or_description_access_level",
                  "edit_team_visibility_or_trash_team_access_level",
                  "endorsed",
                  "guest_invite_management_access_level",
                  "html_description",
                  "join_request_management_access_level",
                  "member_invite_management_access_level",
                  "name",
                  "organization",
                  "organization.name",
                  "permalink_url",
                  "team_content_management_access_level",
                  "team_member_removal_access_level",
                  "visibility"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TeamResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TeamResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the record for a single team."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "teams:read"
            ]
          }
        ],
        "summary": "Get a team",
        "tags": [
          "Teams"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1teams~1{team_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nTeam result = client.teams.getTeam(teamGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet teamsApiInstance = new Asana.TeamsApi(client);\nlet team_gid = \"159874\"; // String | Globally unique identifier for the team.\nlet opts = { \n    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,description,edit_team_name_or_description_access_level,edit_team_visibility_or_trash_team_access_level,endorsed,guest_invite_management_access_level,html_description,join_request_management_access_level,member_invite_management_access_level,name,organization,organization.name,permalink_url,team_content_management_access_level,team_member_removal_access_level,visibility\"\n};\nteamsApiInstance.getTeam(team_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.teams.getTeam(teamGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nteams_api_instance = asana.TeamsApi(api_client)\nteam_gid = \"159874\" # str | Globally unique identifier for the team.\nopts = {\n    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,description,edit_team_name_or_description_access_level,edit_team_visibility_or_trash_team_access_level,endorsed,guest_invite_management_access_level,html_description,join_request_management_access_level,member_invite_management_access_level,name,organization,organization.name,permalink_url,team_content_management_access_level,team_member_removal_access_level,visibility\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a team\n    api_response = teams_api_instance.get_team(team_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TeamsApi->get_team: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.teams.get_team(team_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->teams->getTeam($team_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.teams.get_team(team_gid: 'team_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/team_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/teams/{team_gid}/addUser": {
      "parameters": [
        {
          "$ref": "#/components/parameters/team_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "The user making this call must be a member of the team in order to add others. The user being added must exist in the same organization as the team.\n\nReturns the complete team membership record for the newly added user.",
        "operationId": "addUserForTeam",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "is_admin",
              "is_guest",
              "is_limited_access",
              "team",
              "team.name",
              "user",
              "user.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "is_admin",
                  "is_guest",
                  "is_limited_access",
                  "team",
                  "team.name",
                  "user",
                  "user.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TeamAddUserRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The user to add to the team.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TeamMembershipResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TeamMembershipResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully added user to the team."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Add a user to a team",
        "tags": [
          "Teams"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1teams~1{team_gid}~1addUser/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.teams.addUserForTeam(teamGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet teamsApiInstance = new Asana.TeamsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The user to add to the team.\nlet team_gid = \"159874\"; // String | Globally unique identifier for the team.\nlet opts = { \n    'opt_fields': \"is_admin,is_guest,is_limited_access,team,team.name,user,user.name\"\n};\nteamsApiInstance.addUserForTeam(body, team_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.teams.addUserForTeam(teamGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nteams_api_instance = asana.TeamsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The user to add to the team.\nteam_gid = \"159874\" # str | Globally unique identifier for the team.\nopts = {\n    'opt_fields': \"is_admin,is_guest,is_limited_access,team,team.name,user,user.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Add a user to a team\n    api_response = teams_api_instance.add_user_for_team(body, team_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TeamsApi->add_user_for_team: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.teams.add_user_for_team(team_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->teams->addUserForTeam($team_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.teams.add_user_for_team(team_gid: 'team_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/teams/{team_gid}/custom_field_settings": {
      "get": {
        "description": "<b>Required scope: </b><code>teams:read</code>\n\nReturns a list of all of the custom fields settings on a team, in compact form. Note that, as in all queries to collections which return compact representation, `opt_fields` can be used to include more data than is returned in the compact representation. See the [documentation for input/output options](https://developers.asana.com/docs/inputoutput-options) for more information.",
        "operationId": "getCustomFieldSettingsForTeam",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "custom_field",
              "custom_field.asana_created_field",
              "custom_field.created_by",
              "custom_field.created_by.name",
              "custom_field.currency_code",
              "custom_field.custom_label",
              "custom_field.custom_label_position",
              "custom_field.date_value",
              "custom_field.date_value.date",
              "custom_field.date_value.date_time",
              "custom_field.default_access_level",
              "custom_field.description",
              "custom_field.display_value",
              "custom_field.enabled",
              "custom_field.enum_options",
              "custom_field.enum_options.color",
              "custom_field.enum_options.enabled",
              "custom_field.enum_options.name",
              "custom_field.enum_value",
              "custom_field.enum_value.color",
              "custom_field.enum_value.enabled",
              "custom_field.enum_value.name",
              "custom_field.format",
              "custom_field.has_notifications_enabled",
              "custom_field.html_text_value",
              "custom_field.id_prefix",
              "custom_field.input_restrictions",
              "custom_field.is_formula_field",
              "custom_field.is_global_to_workspace",
              "custom_field.is_lookup_field",
              "custom_field.is_value_read_only",
              "custom_field.multi_enum_values",
              "custom_field.multi_enum_values.color",
              "custom_field.multi_enum_values.enabled",
              "custom_field.multi_enum_values.name",
              "custom_field.name",
              "custom_field.number_value",
              "custom_field.people_value",
              "custom_field.people_value.name",
              "custom_field.precision",
              "custom_field.privacy_setting",
              "custom_field.reference_value",
              "custom_field.reference_value.name",
              "custom_field.representation_type",
              "custom_field.resource_subtype",
              "custom_field.text_value",
              "custom_field.type",
              "is_important",
              "parent",
              "parent.name",
              "parent.resource_subtype",
              "project",
              "project.name",
              "project.resource_subtype"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "custom_field",
                  "custom_field.asana_created_field",
                  "custom_field.created_by",
                  "custom_field.created_by.name",
                  "custom_field.currency_code",
                  "custom_field.custom_label",
                  "custom_field.custom_label_position",
                  "custom_field.date_value",
                  "custom_field.date_value.date",
                  "custom_field.date_value.date_time",
                  "custom_field.default_access_level",
                  "custom_field.description",
                  "custom_field.display_value",
                  "custom_field.enabled",
                  "custom_field.enum_options",
                  "custom_field.enum_options.color",
                  "custom_field.enum_options.enabled",
                  "custom_field.enum_options.name",
                  "custom_field.enum_value",
                  "custom_field.enum_value.color",
                  "custom_field.enum_value.enabled",
                  "custom_field.enum_value.name",
                  "custom_field.format",
                  "custom_field.has_notifications_enabled",
                  "custom_field.html_text_value",
                  "custom_field.id_prefix",
                  "custom_field.input_restrictions",
                  "custom_field.is_formula_field",
                  "custom_field.is_global_to_workspace",
                  "custom_field.is_lookup_field",
                  "custom_field.is_value_read_only",
                  "custom_field.multi_enum_values",
                  "custom_field.multi_enum_values.color",
                  "custom_field.multi_enum_values.enabled",
                  "custom_field.multi_enum_values.name",
                  "custom_field.name",
                  "custom_field.number_value",
                  "custom_field.people_value",
                  "custom_field.people_value.name",
                  "custom_field.precision",
                  "custom_field.privacy_setting",
                  "custom_field.reference_value",
                  "custom_field.reference_value.name",
                  "custom_field.representation_type",
                  "custom_field.resource_subtype",
                  "custom_field.text_value",
                  "custom_field.type",
                  "is_important",
                  "parent",
                  "parent.name",
                  "parent.resource_subtype",
                  "project",
                  "project.name",
                  "project.resource_subtype"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/CustomFieldSettingResponse"
                          },
                          "type": "array"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__CustomFieldSettingResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved custom field settings objects for a team."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "teams:read"
            ]
          }
        ],
        "summary": "Get a team's custom fields",
        "tags": [
          "Custom field settings"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1teams~1{team_gid}~1custom_field_settings/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet customFieldSettingsApiInstance = new Asana.CustomFieldSettingsApi(client);\nlet team_gid = \"159874\"; // String | Globally unique identifier for the team.\nlet opts = { \n    'opt_fields': \"custom_field,custom_field.asana_created_field,custom_field.created_by,custom_field.created_by.name,custom_field.currency_code,custom_field.custom_label,custom_field.custom_label_position,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.default_access_level,custom_field.description,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.format,custom_field.has_notifications_enabled,custom_field.html_text_value,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_global_to_workspace,custom_field.is_lookup_field,custom_field.is_value_read_only,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.people_value,custom_field.people_value.name,custom_field.precision,custom_field.privacy_setting,custom_field.reference_value,custom_field.reference_value.name,custom_field.representation_type,custom_field.resource_subtype,custom_field.text_value,custom_field.type,is_important,parent,parent.name,parent.resource_subtype,project,project.name,project.resource_subtype\"\n};\ncustomFieldSettingsApiInstance.getCustomFieldSettingsForTeam(team_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ncustom_field_settings_api_instance = asana.CustomFieldSettingsApi(api_client)\nteam_gid = \"159874\" # str | Globally unique identifier for the team.\nopts = {\n    'opt_fields': \"custom_field,custom_field.asana_created_field,custom_field.created_by,custom_field.created_by.name,custom_field.currency_code,custom_field.custom_label,custom_field.custom_label_position,custom_field.date_value,custom_field.date_value.date,custom_field.date_value.date_time,custom_field.default_access_level,custom_field.description,custom_field.display_value,custom_field.enabled,custom_field.enum_options,custom_field.enum_options.color,custom_field.enum_options.enabled,custom_field.enum_options.name,custom_field.enum_value,custom_field.enum_value.color,custom_field.enum_value.enabled,custom_field.enum_value.name,custom_field.format,custom_field.has_notifications_enabled,custom_field.html_text_value,custom_field.id_prefix,custom_field.input_restrictions,custom_field.is_formula_field,custom_field.is_global_to_workspace,custom_field.is_lookup_field,custom_field.is_value_read_only,custom_field.multi_enum_values,custom_field.multi_enum_values.color,custom_field.multi_enum_values.enabled,custom_field.multi_enum_values.name,custom_field.name,custom_field.number_value,custom_field.people_value,custom_field.people_value.name,custom_field.precision,custom_field.privacy_setting,custom_field.reference_value,custom_field.reference_value.name,custom_field.representation_type,custom_field.resource_subtype,custom_field.text_value,custom_field.type,is_important,parent,parent.name,parent.resource_subtype,project,project.name,project.resource_subtype\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a team's custom fields\n    api_response = custom_field_settings_api_instance.get_custom_field_settings_for_team(team_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling CustomFieldSettingsApi->get_custom_field_settings_for_team: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/team_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/teams/{team_gid}/project_templates": {
      "get": {
        "description": "<b>Required scope: </b><code>project_templates:read</code>\n\nReturns the compact project template records for all project templates in the team.",
        "operationId": "getProjectTemplatesForTeam",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "color",
              "description",
              "html_description",
              "name",
              "offset",
              "owner",
              "path",
              "public",
              "requested_dates",
              "requested_dates.description",
              "requested_dates.name",
              "requested_roles",
              "requested_roles.name",
              "team",
              "team.name",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "color",
                  "description",
                  "html_description",
                  "name",
                  "offset",
                  "owner",
                  "path",
                  "public",
                  "requested_dates",
                  "requested_dates.description",
                  "requested_dates.name",
                  "requested_roles",
                  "requested_roles.name",
                  "team",
                  "team.name",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/ProjectTemplateCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ProjectTemplateResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested team's project templates."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "project_templates:read"
            ]
          }
        ],
        "summary": "Get a team's project templates",
        "tags": [
          "Project templates"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1teams~1{team_gid}~1project_templates/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<JsonElement> result = client.projecttemplates.getProjectTemplatesForTeam(teamGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectTemplatesApiInstance = new Asana.ProjectTemplatesApi(client);\nlet team_gid = \"159874\"; // String | Globally unique identifier for the team.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"color,description,html_description,name,offset,owner,path,public,requested_dates,requested_dates.description,requested_dates.name,requested_roles,requested_roles.name,team,team.name,uri\"\n};\nprojectTemplatesApiInstance.getProjectTemplatesForTeam(team_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projecttemplates.getProjectTemplatesForTeam(teamGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nproject_templates_api_instance = asana.ProjectTemplatesApi(api_client)\nteam_gid = \"159874\" # str | Globally unique identifier for the team.\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    'opt_fields': \"color,description,html_description,name,offset,owner,path,public,requested_dates,requested_dates.description,requested_dates.name,requested_roles,requested_roles.name,team,team.name,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a team's project templates\n    api_response = project_templates_api_instance.get_project_templates_for_team(team_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectTemplatesApi->get_project_templates_for_team: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.project_templates.get_project_templates_for_team(team_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projecttemplates->getProjectTemplatesForTeam($team_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.project_templates.get_project_templates_for_team(team_gid: 'team_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/team_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/teams/{team_gid}/projects": {
      "get": {
        "description": "<b>Required scope: </b><code>projects:read</code>\n\nReturns the compact project records for all projects in the team.",
        "operationId": "getProjectsForTeam",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "$ref": "#/components/parameters/archived_query_param"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "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.default_access_level",
              "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.html_text_value",
              "custom_field_settings.custom_field.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_global_to_workspace",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.privacy_setting",
              "custom_field_settings.custom_field.reference_value",
              "custom_field_settings.custom_field.reference_value.name",
              "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.parent.resource_subtype",
              "custom_field_settings.project",
              "custom_field_settings.project.name",
              "custom_field_settings.project.resource_subtype",
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "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",
              "resource_subtype",
              "start_on",
              "team",
              "team.name",
              "uri",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "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.default_access_level",
                  "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.html_text_value",
                  "custom_field_settings.custom_field.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_global_to_workspace",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.privacy_setting",
                  "custom_field_settings.custom_field.reference_value",
                  "custom_field_settings.custom_field.reference_value.name",
                  "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.parent.resource_subtype",
                  "custom_field_settings.project",
                  "custom_field_settings.project.name",
                  "custom_field_settings.project.resource_subtype",
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "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",
                  "resource_subtype",
                  "start_on",
                  "team",
                  "team.name",
                  "uri",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/ProjectCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ProjectResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested team's projects."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "projects:read"
            ]
          }
        ],
        "summary": "Get a team's projects",
        "tags": [
          "Projects"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1teams~1{team_gid}~1projects/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Project> result = client.projects.getProjectsForTeam(teamGid, archived)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectsApiInstance = new Asana.ProjectsApi(client);\nlet team_gid = \"159874\"; // String | Globally unique identifier for the team.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,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,resource_subtype,start_on,team,team.name,uri,workspace,workspace.name\"\n};\nprojectsApiInstance.getProjectsForTeam(team_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projects.getProjectsForTeam(teamGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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)\nteam_gid = \"159874\" # str | Globally unique identifier for the team.\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    '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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,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,resource_subtype,start_on,team,team.name,uri,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a team's projects\n    api_response = projects_api_instance.get_projects_for_team(team_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectsApi->get_projects_for_team: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.projects.get_projects_for_team(team_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projects->getProjectsForTeam($team_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "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_for_team(team_gid: 'team_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/team_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/teams/{team_gid}/removeUser": {
      "parameters": [
        {
          "$ref": "#/components/parameters/team_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "The user making this call must be a member of the team in order to remove themselves or others.",
        "operationId": "removeUserForTeam",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TeamRemoveUserRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The user to remove from the team.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Returns an empty data record"
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Remove a user from a team",
        "tags": [
          "Teams"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1teams~1{team_gid}~1removeUser/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.teams.removeUserForTeam(teamGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet teamsApiInstance = new Asana.TeamsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The user to remove from the team.\nlet team_gid = \"159874\"; // String | Globally unique identifier for the team.\n\nteamsApiInstance.removeUserForTeam(body, team_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.teams.removeUserForTeam(teamGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nteams_api_instance = asana.TeamsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The user to remove from the team.\nteam_gid = \"159874\" # str | Globally unique identifier for the team.\n\n\ntry:\n    # Remove a user from a team\n    api_response = teams_api_instance.remove_user_for_team(body, team_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TeamsApi->remove_user_for_team: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.teams.remove_user_for_team(team_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->teams->removeUserForTeam($team_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.teams.remove_user_for_team(team_gid: 'team_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/teams/{team_gid}/team_memberships": {
      "get": {
        "description": "<b>Required scope: </b><code>team_memberships:read</code>\n\nReturns the compact team memberships for the team.",
        "operationId": "getTeamMembershipsForTeam",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "is_admin",
              "is_guest",
              "is_limited_access",
              "offset",
              "path",
              "team",
              "team.name",
              "uri",
              "user",
              "user.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "is_admin",
                  "is_guest",
                  "is_limited_access",
                  "offset",
                  "path",
                  "team",
                  "team.name",
                  "uri",
                  "user",
                  "user.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TeamMembershipCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TeamMembershipResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested team's memberships."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "team_memberships:read"
            ]
          }
        ],
        "summary": "Get memberships from a team",
        "tags": [
          "Team memberships"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1teams~1{team_gid}~1team_memberships/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<JsonElement> result = client.teammemberships.getTeamMembershipsForTeam(teamGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet teamMembershipsApiInstance = new Asana.TeamMembershipsApi(client);\nlet team_gid = \"159874\"; // String | Globally unique identifier for the team.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"is_admin,is_guest,is_limited_access,offset,path,team,team.name,uri,user,user.name\"\n};\nteamMembershipsApiInstance.getTeamMembershipsForTeam(team_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.teammemberships.getTeamMembershipsForTeam(teamGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nteam_memberships_api_instance = asana.TeamMembershipsApi(api_client)\nteam_gid = \"159874\" # str | Globally unique identifier for the team.\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    'opt_fields': \"is_admin,is_guest,is_limited_access,offset,path,team,team.name,uri,user,user.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get memberships from a team\n    api_response = team_memberships_api_instance.get_team_memberships_for_team(team_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TeamMembershipsApi->get_team_memberships_for_team: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.team_memberships.get_team_memberships_for_team(team_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->teammemberships->getTeamMembershipsForTeam($team_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.team_memberships.get_team_memberships_for_team(team_gid: 'team_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/team_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/teams/{team_gid}/users": {
      "get": {
        "description": "<b>Required scope: </b><code>users:read</code>\n\nReturns the compact records for all users that are members of the team.\nResults are sorted alphabetically and limited to 2000. For more results use the `/users` endpoint.",
        "operationId": "getUsersForTeam",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "email",
              "name",
              "photo",
              "photo.image_1024x1024",
              "photo.image_128x128",
              "photo.image_21x21",
              "photo.image_27x27",
              "photo.image_36x36",
              "photo.image_60x60",
              "workspaces",
              "workspaces.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "email",
                  "name",
                  "photo",
                  "photo.image_1024x1024",
                  "photo.image_128x128",
                  "photo.image_21x21",
                  "photo.image_27x27",
                  "photo.image_36x36",
                  "photo.image_60x60",
                  "workspaces",
                  "workspaces.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/UserCompact"
                          },
                          "type": "array"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__UserResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Returns the user records for all the members of the team, including guests and limited access users."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "users:read"
            ]
          }
        ],
        "summary": "Get users in a team",
        "tags": [
          "Users"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1teams~1{team_gid}~1users/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<User> result = client.users.getUsersForTeam(teamGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet usersApiInstance = new Asana.UsersApi(client);\nlet team_gid = \"159874\"; // String | Globally unique identifier for the team.\nlet opts = { \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,email,name,photo,photo.image_1024x1024,photo.image_128x128,photo.image_21x21,photo.image_27x27,photo.image_36x36,photo.image_60x60,workspaces,workspaces.name\"\n};\nusersApiInstance.getUsersForTeam(team_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.users.getUsersForTeam(teamGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nusers_api_instance = asana.UsersApi(api_client)\nteam_gid = \"159874\" # str | Globally unique identifier for the team.\nopts = {\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    'opt_fields': \"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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,email,name,photo,photo.image_1024x1024,photo.image_128x128,photo.image_21x21,photo.image_27x27,photo.image_36x36,photo.image_60x60,workspaces,workspaces.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get users in a team\n    api_response = users_api_instance.get_users_for_team(team_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling UsersApi->get_users_for_team: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.users.get_users_for_team(team_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->users->getUsersForTeam($team_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.users.get_users_for_team(team_gid: 'team_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/team_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/time_periods": {
      "get": {
        "description": "Returns compact time period records.",
        "operationId": "getTimePeriods",
        "parameters": [
          {
            "description": "ISO 8601 date string",
            "example": "2019-09-15",
            "in": "query",
            "name": "start_on",
            "schema": {
              "format": "date",
              "type": "string"
            }
          },
          {
            "description": "ISO 8601 date string",
            "example": "2019-09-15",
            "in": "query",
            "name": "end_on",
            "schema": {
              "format": "date",
              "type": "string"
            }
          },
          {
            "description": "Globally unique identifier for the workspace.",
            "example": "31326",
            "in": "query",
            "name": "workspace",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "display_name",
              "end_on",
              "offset",
              "parent",
              "parent.display_name",
              "parent.end_on",
              "parent.period",
              "parent.start_on",
              "path",
              "period",
              "start_on",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "display_name",
                  "end_on",
                  "offset",
                  "parent",
                  "parent.display_name",
                  "parent.end_on",
                  "parent.period",
                  "parent.start_on",
                  "path",
                  "period",
                  "start_on",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TimePeriodCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TimePeriodResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested time periods."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get time periods",
        "tags": [
          "Time periods"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1time_periods/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<JsonElement> result = client.timeperiods.getTimePeriods(endOn, startOn, workspace)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet timePeriodsApiInstance = new Asana.TimePeriodsApi(client);\nlet workspace = \"31326\"; // String | Globally unique identifier for the workspace.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'start_on': \"2019-09-15\", \n    'end_on': \"2019-09-15\", \n    'opt_fields': \"display_name,end_on,offset,parent,parent.display_name,parent.end_on,parent.period,parent.start_on,path,period,start_on,uri\"\n};\ntimePeriodsApiInstance.getTimePeriods(workspace, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.timeperiods.getTimePeriods({param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntime_periods_api_instance = asana.TimePeriodsApi(api_client)\nworkspace = \"31326\" # str | Globally unique identifier for the workspace.\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    'start_on': '2019-09-15', # date | ISO 8601 date string\n    'end_on': '2019-09-15', # date | ISO 8601 date string\n    'opt_fields': \"display_name,end_on,offset,parent,parent.display_name,parent.end_on,parent.period,parent.start_on,path,period,start_on,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get time periods\n    api_response = time_periods_api_instance.get_time_periods(workspace, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TimePeriodsApi->get_time_periods: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.time_periods.get_time_periods({'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->timeperiods->getTimePeriods(array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.time_periods.get_time_periods(workspace: '&#x27;workspace_example&#x27;', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/time_periods/{time_period_gid}": {
      "get": {
        "description": "Returns the full record for a single time period.",
        "operationId": "getTimePeriod",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "display_name",
              "end_on",
              "parent",
              "parent.display_name",
              "parent.end_on",
              "parent.period",
              "parent.start_on",
              "period",
              "start_on"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "display_name",
                  "end_on",
                  "parent",
                  "parent.display_name",
                  "parent.end_on",
                  "parent.period",
                  "parent.start_on",
                  "period",
                  "start_on"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TimePeriodResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TimePeriodResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the record for a single time period."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get a time period",
        "tags": [
          "Time periods"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1time_periods~1{time_period_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.timeperiods.getTimePeriod(timePeriodGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet timePeriodsApiInstance = new Asana.TimePeriodsApi(client);\nlet time_period_gid = \"917392\"; // String | Globally unique identifier for the time period.\nlet opts = { \n    'opt_fields': \"display_name,end_on,parent,parent.display_name,parent.end_on,parent.period,parent.start_on,period,start_on\"\n};\ntimePeriodsApiInstance.getTimePeriod(time_period_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.timeperiods.getTimePeriod(timePeriodGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntime_periods_api_instance = asana.TimePeriodsApi(api_client)\ntime_period_gid = \"917392\" # str | Globally unique identifier for the time period.\nopts = {\n    'opt_fields': \"display_name,end_on,parent,parent.display_name,parent.end_on,parent.period,parent.start_on,period,start_on\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a time period\n    api_response = time_periods_api_instance.get_time_period(time_period_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TimePeriodsApi->get_time_period: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.time_periods.get_time_period(time_period_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->timeperiods->getTimePeriod($time_period_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.time_periods.get_time_period(time_period_gid: 'time_period_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/time_period_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/time_tracking_categories": {
      "get": {
        "description": "<b>Required scope: </b><code>time_tracking_categories:read</code>\n\nReturns a paginated list of time tracking categories for a given workspace.",
        "operationId": "getTimeTrackingCategories",
        "parameters": [
          {
            "description": "Globally unique identifier for the workspace.",
            "example": "12345",
            "in": "query",
            "name": "workspace",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter by archived status. If not provided, defaults to returning non-archived categories.",
            "example": false,
            "in": "query",
            "name": "is_archived",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "color",
              "is_archived",
              "name",
              "offset",
              "path",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "color",
                  "is_archived",
                  "name",
                  "offset",
                  "path",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TimeTrackingCategoryCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TimeTrackingCategoryResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested time tracking categories."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "time_tracking_categories:read"
            ]
          }
        ],
        "summary": "Get time tracking categories for a workspace",
        "tags": [
          "Time tracking categories"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1time_tracking_categories/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet timeTrackingCategoriesApiInstance = new Asana.TimeTrackingCategoriesApi(client);\nlet workspace = \"12345\"; // String | Globally unique identifier for the workspace.\nlet opts = { \n    'is_archived': false, \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"color,is_archived,name,offset,path,uri\"\n};\ntimeTrackingCategoriesApiInstance.getTimeTrackingCategories(workspace, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ntime_tracking_categories_api_instance = asana.TimeTrackingCategoriesApi(api_client)\nworkspace = \"12345\" # str | Globally unique identifier for the workspace.\nopts = {\n    'is_archived': False, # bool | Filter by archived status. If not provided, defaults to returning non-archived categories.\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    'opt_fields': \"color,is_archived,name,offset,path,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get time tracking categories for a workspace\n    api_response = time_tracking_categories_api_instance.get_time_tracking_categories(workspace, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TimeTrackingCategoriesApi->get_time_tracking_categories: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>time_tracking_categories:write</code>\n\nCreates a new time tracking category in a given workspace.\n\nReturns the record of the newly created time tracking category.",
        "operationId": "createTimeTrackingCategory",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "color",
              "is_archived",
              "name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "color",
                  "is_archived",
                  "name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TimeTrackingCategoryCreateRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "Information about the time tracking category.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TimeTrackingCategoryResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TimeTrackingCategoryResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created a time tracking category."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "time_tracking_categories:write"
            ]
          }
        ],
        "summary": "Create a time tracking category",
        "tags": [
          "Time tracking categories"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1time_tracking_categories/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet timeTrackingCategoriesApiInstance = new Asana.TimeTrackingCategoriesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | Information about the time tracking category.\nlet opts = { \n    'opt_fields': \"color,is_archived,name\"\n};\ntimeTrackingCategoriesApiInstance.createTimeTrackingCategory(body, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ntime_tracking_categories_api_instance = asana.TimeTrackingCategoriesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | Information about the time tracking category.\nopts = {\n    'opt_fields': \"color,is_archived,name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create a time tracking category\n    api_response = time_tracking_categories_api_instance.create_time_tracking_category(body, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TimeTrackingCategoriesApi->create_time_tracking_category: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/time_tracking_categories/{time_tracking_category_gid}": {
      "delete": {
        "description": "<b>Required scope: </b><code>time_tracking_categories:delete</code>\n\nDeletes a specific, existing time tracking category.\n\nReturns an empty data record.",
        "operationId": "deleteTimeTrackingCategory",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully deleted the specified time tracking category."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "time_tracking_categories:delete"
            ]
          }
        ],
        "summary": "Delete a time tracking category",
        "tags": [
          "Time tracking categories"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1time_tracking_categories~1{time_tracking_category_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet timeTrackingCategoriesApiInstance = new Asana.TimeTrackingCategoriesApi(client);\nlet time_tracking_category_gid = \"917392\"; // String | Globally unique identifier for the time tracking category.\n\ntimeTrackingCategoriesApiInstance.deleteTimeTrackingCategory(time_tracking_category_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ntime_tracking_categories_api_instance = asana.TimeTrackingCategoriesApi(api_client)\ntime_tracking_category_gid = \"917392\" # str | Globally unique identifier for the time tracking category.\n\n\ntry:\n    # Delete a time tracking category\n    api_response = time_tracking_categories_api_instance.delete_time_tracking_category(time_tracking_category_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TimeTrackingCategoriesApi->delete_time_tracking_category: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "get": {
        "description": "<b>Required scope: </b><code>time_tracking_categories:read</code>\n\nReturns the complete time tracking category record for a single time tracking category.",
        "operationId": "getTimeTrackingCategory",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "color",
              "is_archived",
              "name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "color",
                  "is_archived",
                  "name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TimeTrackingCategoryResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TimeTrackingCategoryResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested time tracking category."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "time_tracking_categories:read"
            ]
          }
        ],
        "summary": "Get a time tracking category",
        "tags": [
          "Time tracking categories"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1time_tracking_categories~1{time_tracking_category_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet timeTrackingCategoriesApiInstance = new Asana.TimeTrackingCategoriesApi(client);\nlet time_tracking_category_gid = \"917392\"; // String | Globally unique identifier for the time tracking category.\nlet opts = { \n    'opt_fields': \"color,is_archived,name\"\n};\ntimeTrackingCategoriesApiInstance.getTimeTrackingCategory(time_tracking_category_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ntime_tracking_categories_api_instance = asana.TimeTrackingCategoriesApi(api_client)\ntime_tracking_category_gid = \"917392\" # str | Globally unique identifier for the time tracking category.\nopts = {\n    'opt_fields': \"color,is_archived,name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a time tracking category\n    api_response = time_tracking_categories_api_instance.get_time_tracking_category(time_tracking_category_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TimeTrackingCategoriesApi->get_time_tracking_category: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/time_tracking_category_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "put": {
        "description": "<b>Required scope: </b><code>time_tracking_categories:write</code>\n\nUpdates the properties of a time tracking category. Only the fields provided in the\n`data` block will be updated; any unspecified fields will remain unchanged.\n\nReturns the complete updated time tracking category record.",
        "operationId": "updateTimeTrackingCategory",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "color",
              "is_archived",
              "name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "color",
                  "is_archived",
                  "name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TimeTrackingCategoryUpdateRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The updated fields for the time tracking category.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TimeTrackingCategoryResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TimeTrackingCategoryResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully updated the time tracking category."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "time_tracking_categories:write"
            ]
          }
        ],
        "summary": "Update a time tracking category",
        "tags": [
          "Time tracking categories"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1time_tracking_categories~1{time_tracking_category_gid}/put",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet timeTrackingCategoriesApiInstance = new Asana.TimeTrackingCategoriesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The updated fields for the time tracking category.\nlet time_tracking_category_gid = \"917392\"; // String | Globally unique identifier for the time tracking category.\nlet opts = { \n    'opt_fields': \"color,is_archived,name\"\n};\ntimeTrackingCategoriesApiInstance.updateTimeTrackingCategory(body, time_tracking_category_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ntime_tracking_categories_api_instance = asana.TimeTrackingCategoriesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The updated fields for the time tracking category.\ntime_tracking_category_gid = \"917392\" # str | Globally unique identifier for the time tracking category.\nopts = {\n    'opt_fields': \"color,is_archived,name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Update a time tracking category\n    api_response = time_tracking_categories_api_instance.update_time_tracking_category(body, time_tracking_category_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TimeTrackingCategoriesApi->update_time_tracking_category: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/time_tracking_categories/{time_tracking_category_gid}/time_tracking_entries": {
      "get": {
        "description": "<b>Required scope: </b><code>time_tracking_categories:read</code>\n\nReturns a paginated list of time tracking entries filtered by a given time tracking category.",
        "operationId": "getTimeTrackingEntriesForTimeTrackingCategory",
        "parameters": [
          {
            "description": "The start date for filtering time tracking entries by their entry date.",
            "example": "2025-01-01",
            "in": "query",
            "name": "start_date",
            "schema": {
              "format": "date",
              "type": "string"
            }
          },
          {
            "description": "The end date for filtering time tracking entries by their entry date.",
            "example": "2025-12-31",
            "in": "query",
            "name": "end_date",
            "schema": {
              "format": "date",
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "assignee",
              "assignee.name",
              "attributable_to",
              "attributable_to.name",
              "attributable_to.resource_subtype",
              "categories",
              "categories.color",
              "categories.name",
              "created_by",
              "created_by.name",
              "duration_minutes",
              "entered_on",
              "offset",
              "path",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "assignee",
                  "assignee.name",
                  "attributable_to",
                  "attributable_to.name",
                  "attributable_to.resource_subtype",
                  "categories",
                  "categories.color",
                  "categories.name",
                  "created_by",
                  "created_by.name",
                  "duration_minutes",
                  "entered_on",
                  "offset",
                  "path",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TimeTrackingEntryCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TimeTrackingEntryCompactArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested time tracking entries."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "time_tracking_categories:read"
            ]
          }
        ],
        "summary": "Get time tracking entries for a time tracking category",
        "tags": [
          "Time tracking categories"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1time_tracking_categories~1{time_tracking_category_gid}~1time_tracking_entries/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet timeTrackingCategoriesApiInstance = new Asana.TimeTrackingCategoriesApi(client);\nlet time_tracking_category_gid = \"917392\"; // String | Globally unique identifier for the time tracking category.\nlet opts = { \n    'start_date': \"2025-01-01\", \n    'end_date': \"2025-12-31\", \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"assignee,assignee.name,attributable_to,attributable_to.name,attributable_to.resource_subtype,categories,categories.color,categories.name,created_by,created_by.name,duration_minutes,entered_on,offset,path,uri\"\n};\ntimeTrackingCategoriesApiInstance.getTimeTrackingEntriesForTimeTrackingCategory(time_tracking_category_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ntime_tracking_categories_api_instance = asana.TimeTrackingCategoriesApi(api_client)\ntime_tracking_category_gid = \"917392\" # str | Globally unique identifier for the time tracking category.\nopts = {\n    'start_date': '2025-01-01', # date | The start date for filtering time tracking entries by their entry date.\n    'end_date': '2025-12-31', # date | The end date for filtering time tracking entries by their entry date.\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    'opt_fields': \"assignee,assignee.name,attributable_to,attributable_to.name,attributable_to.resource_subtype,categories,categories.color,categories.name,created_by,created_by.name,duration_minutes,entered_on,offset,path,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get time tracking entries for a time tracking category\n    api_response = time_tracking_categories_api_instance.get_time_tracking_entries_for_time_tracking_category(time_tracking_category_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TimeTrackingCategoriesApi->get_time_tracking_entries_for_time_tracking_category: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/time_tracking_category_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/time_tracking_entries": {
      "get": {
        "description": "<b>Required scope: </b><code>time_tracking_entries:read</code>\n\nReturns a list of time tracking entries filtered to a task, attributed project, portfolio or user.",
        "operationId": "getTimeTrackingEntries",
        "parameters": [
          {
            "description": "Globally unique identifier for the task to filter time tracking entries by.",
            "example": "12345",
            "in": "query",
            "name": "task",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Globally unique identifier for the project the time tracking entries are attributed to.",
            "example": "12345",
            "in": "query",
            "name": "attributable_to",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Globally unique identifier for the portfolio to filter time tracking entries by.",
            "example": "12345",
            "in": "query",
            "name": "portfolio",
            "schema": {
              "type": "string"
            }
          },
          {
            "deprecated": true,
            "description": "*Deprecated - please use assignee instead* Globally unique identifier for the user the time tracking entry's logged time is attributed to, to filter time tracking entries by.",
            "example": "12345",
            "in": "query",
            "name": "user",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Globally unique identifier for the user the time tracking entry's logged time is attributed to, to filter time tracking entries by.",
            "example": "12345",
            "in": "query",
            "name": "assignee",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Globally unique identifier for the workspace. At least one of `entered_on_start_date` or `entered_on_end_date` must be provided when filtering by workspace.",
            "example": "98765",
            "in": "query",
            "name": "workspace",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The start date for filtering time tracking entries by when they were entered.",
            "example": "2025-01-01",
            "in": "query",
            "name": "entered_on_start_date",
            "schema": {
              "format": "date",
              "type": "string"
            }
          },
          {
            "description": "The end date for filtering time tracking entries by when they were entered.",
            "example": "2025-12-31",
            "in": "query",
            "name": "entered_on_end_date",
            "schema": {
              "format": "date",
              "type": "string"
            }
          },
          {
            "description": "Globally unique identifier for the timesheet approval status to filter time tracking entries by.",
            "example": "12345",
            "in": "query",
            "name": "timesheet_approval_status",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "assignee",
              "assignee.name",
              "attributable_to",
              "attributable_to.name",
              "attributable_to.resource_subtype",
              "categories",
              "categories.color",
              "categories.name",
              "created_by",
              "created_by.name",
              "duration_minutes",
              "entered_on",
              "offset",
              "path",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "assignee",
                  "assignee.name",
                  "attributable_to",
                  "attributable_to.name",
                  "attributable_to.resource_subtype",
                  "categories",
                  "categories.color",
                  "categories.name",
                  "created_by",
                  "created_by.name",
                  "duration_minutes",
                  "entered_on",
                  "offset",
                  "path",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TimeTrackingEntryCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TimeTrackingEntryCompactArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested time tracking entries."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "time_tracking_entries:read"
            ]
          }
        ],
        "summary": "Get multiple time tracking entries",
        "tags": [
          "Time tracking entries"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1time_tracking_entries/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet timeTrackingEntriesApiInstance = new Asana.TimeTrackingEntriesApi(client);\nlet opts = { \n    'task': \"12345\", \n    'attributable_to': \"12345\", \n    'portfolio': \"12345\", \n    'user': \"12345\", \n    'assignee': \"12345\", \n    'workspace': \"98765\", \n    'entered_on_start_date': \"2025-01-01\", \n    'entered_on_end_date': \"2025-12-31\", \n    'timesheet_approval_status': \"12345\", \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"assignee,assignee.name,attributable_to,attributable_to.name,attributable_to.resource_subtype,categories,categories.color,categories.name,created_by,created_by.name,duration_minutes,entered_on,offset,path,uri\"\n};\ntimeTrackingEntriesApiInstance.getTimeTrackingEntries(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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ntime_tracking_entries_api_instance = asana.TimeTrackingEntriesApi(api_client)\nopts = {\n    'task': \"12345\", # str | Globally unique identifier for the task to filter time tracking entries by.\n    'attributable_to': \"12345\", # str | Globally unique identifier for the project the time tracking entries are attributed to.\n    'portfolio': \"12345\", # str | Globally unique identifier for the portfolio to filter time tracking entries by.\n    'user': \"12345\", # str | *Deprecated - please use assignee instead* Globally unique identifier for the user the time tracking entry's logged time is attributed to, to filter time tracking entries by.\n    'assignee': \"12345\", # str | Globally unique identifier for the user the time tracking entry's logged time is attributed to, to filter time tracking entries by.\n    'workspace': \"98765\", # str | Globally unique identifier for the workspace. At least one of `entered_on_start_date` or `entered_on_end_date` must be provided when filtering by workspace.\n    'entered_on_start_date': '2025-01-01', # date | The start date for filtering time tracking entries by when they were entered.\n    'entered_on_end_date': '2025-12-31', # date | The end date for filtering time tracking entries by when they were entered.\n    'timesheet_approval_status': \"12345\", # str | Globally unique identifier for the timesheet approval status to filter time tracking entries by.\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    'opt_fields': \"assignee,assignee.name,attributable_to,attributable_to.name,attributable_to.resource_subtype,categories,categories.color,categories.name,created_by,created_by.name,duration_minutes,entered_on,offset,path,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get multiple time tracking entries\n    api_response = time_tracking_entries_api_instance.get_time_tracking_entries(opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TimeTrackingEntriesApi->get_time_tracking_entries: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/time_tracking_entries/{time_tracking_entry_gid}": {
      "delete": {
        "description": "A specific, existing time tracking entry can be deleted by making a `DELETE` request on\nthe URL for that time tracking entry.\n\nReturns an empty data record.\n\n#### Access requirements\n\nThis endpoint is available only when time tracking is available through the domain's\nplan or add-ons. A request from a domain without time tracking access returns a\n`402 Payment Required` error.",
        "operationId": "deleteTimeTrackingEntry",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully deleted the specified time tracking entry."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Delete a time tracking entry",
        "tags": [
          "Time tracking entries"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1time_tracking_entries~1{time_tracking_entry_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet timeTrackingEntriesApiInstance = new Asana.TimeTrackingEntriesApi(client);\nlet time_tracking_entry_gid = \"917392\"; // String | Globally unique identifier for the time tracking entry.\n\ntimeTrackingEntriesApiInstance.deleteTimeTrackingEntry(time_tracking_entry_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.timetrackingentries.deleteTimeTrackingEntry(timeTrackingEntryGid)\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntime_tracking_entries_api_instance = asana.TimeTrackingEntriesApi(api_client)\ntime_tracking_entry_gid = \"917392\" # str | Globally unique identifier for the time tracking entry.\n\n\ntry:\n    # Delete a time tracking entry\n    api_response = time_tracking_entries_api_instance.delete_time_tracking_entry(time_tracking_entry_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TimeTrackingEntriesApi->delete_time_tracking_entry: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.time_tracking_entries.delete_time_tracking_entry(time_tracking_entry_gid, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            }
          ]
        }
      },
      "get": {
        "description": "<b>Required scope: </b><code>time_tracking_entries:read</code>\n\n<table>\n  <tr>\n    <th>Field</th>\n    <th>Required Scope</th>\n  </tr>\n  <tr>\n    <td><code>categories</code></td>\n    <td><code>time_tracking_categories:read</code></td>\n  </tr>\n</table>\n\nReturns the complete time tracking entry record for a single time tracking entry.",
        "operationId": "getTimeTrackingEntry",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "approval_status",
              "assignee",
              "assignee.name",
              "attributable_to",
              "attributable_to.name",
              "attributable_to.resource_subtype",
              "billable_status",
              "categories",
              "categories.color",
              "categories.name",
              "created_at",
              "created_by",
              "created_by.name",
              "description",
              "duration_minutes",
              "entered_on",
              "task",
              "task.created_by",
              "task.name",
              "task.resource_subtype"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "approval_status",
                  "assignee",
                  "assignee.name",
                  "attributable_to",
                  "attributable_to.name",
                  "attributable_to.resource_subtype",
                  "billable_status",
                  "categories",
                  "categories.color",
                  "categories.name",
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "description",
                  "duration_minutes",
                  "entered_on",
                  "task",
                  "task.created_by",
                  "task.name",
                  "task.resource_subtype"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TimeTrackingEntryBase"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TimeTrackingEntryBaseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested time tracking entry."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "time_tracking_entries:read"
            ]
          }
        ],
        "summary": "Get a time tracking entry",
        "tags": [
          "Time tracking entries"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1time_tracking_entries~1{time_tracking_entry_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet timeTrackingEntriesApiInstance = new Asana.TimeTrackingEntriesApi(client);\nlet time_tracking_entry_gid = \"917392\"; // String | Globally unique identifier for the time tracking entry.\nlet opts = { \n    'opt_fields': \"approval_status,assignee,assignee.name,attributable_to,attributable_to.name,attributable_to.resource_subtype,billable_status,categories,categories.color,categories.name,created_at,created_by,created_by.name,description,duration_minutes,entered_on,task,task.created_by,task.name,task.resource_subtype\"\n};\ntimeTrackingEntriesApiInstance.getTimeTrackingEntry(time_tracking_entry_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.timetrackingentries.getTimeTrackingEntry(timeTrackingEntryGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntime_tracking_entries_api_instance = asana.TimeTrackingEntriesApi(api_client)\ntime_tracking_entry_gid = \"917392\" # str | Globally unique identifier for the time tracking entry.\nopts = {\n    'opt_fields': \"approval_status,assignee,assignee.name,attributable_to,attributable_to.name,attributable_to.resource_subtype,billable_status,categories,categories.color,categories.name,created_at,created_by,created_by.name,description,duration_minutes,entered_on,task,task.created_by,task.name,task.resource_subtype\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a time tracking entry\n    api_response = time_tracking_entries_api_instance.get_time_tracking_entry(time_tracking_entry_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TimeTrackingEntriesApi->get_time_tracking_entry: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.time_tracking_entries.get_time_tracking_entry(time_tracking_entry_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/time_tracking_entry_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "put": {
        "description": "A specific, existing time tracking entry can be updated by making a `PUT` request on\nthe URL for that time tracking entry. Only the fields provided in the `data` block\nwill be updated; any unspecified fields will remain unchanged.\n\nWhen using this method, it is best to specify only those fields you wish\nto change, or else you may overwrite changes made by another user since\nyou last retrieved the task.\n\nReturns the complete updated time tracking entry record.\n\n#### Access requirements\n\nAccess to this endpoint has two levels:\n\n- **Endpoint access** requires time tracking to be available through the domain's plan\nor add-ons. A request from a domain without time tracking access returns a\n`402 Payment Required` error for every request to this endpoint.\n\n- **Field access** for some request fields requires the Timesheets and Budgets add-on.\nFields with this requirement are noted in the request schema. Including one of these\nfields without the add-on returns a `402 Payment Required` error, even when the rest of\nthe request is valid.\n\nBecause the field-level requirement is separate, the same endpoint may return `200` or\n`402` for the same domain depending on which fields are sent: a request that only uses\nfields available with endpoint access succeeds on any domain that meets the endpoint\nrequirement, while a request that includes a field requiring the add-on also requires\nthe add-on.",
        "operationId": "updateTimeTrackingEntry",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "approval_status",
              "assignee",
              "assignee.name",
              "attributable_to",
              "attributable_to.name",
              "attributable_to.resource_subtype",
              "billable_status",
              "categories",
              "categories.color",
              "categories.name",
              "created_at",
              "created_by",
              "created_by.name",
              "description",
              "duration_minutes",
              "entered_on",
              "task",
              "task.created_by",
              "task.name",
              "task.resource_subtype"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "approval_status",
                  "assignee",
                  "assignee.name",
                  "attributable_to",
                  "attributable_to.name",
                  "attributable_to.resource_subtype",
                  "billable_status",
                  "categories",
                  "categories.color",
                  "categories.name",
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "description",
                  "duration_minutes",
                  "entered_on",
                  "task",
                  "task.created_by",
                  "task.name",
                  "task.resource_subtype"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/UpdateTimeTrackingEntryRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The updated fields for the time tracking entry.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TimeTrackingEntryBase"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TimeTrackingEntryBaseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully updated the time tracking entry."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Update a time tracking entry",
        "tags": [
          "Time tracking entries"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1time_tracking_entries~1{time_tracking_entry_gid}/put",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet timeTrackingEntriesApiInstance = new Asana.TimeTrackingEntriesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The updated fields for the time tracking entry.\nlet time_tracking_entry_gid = \"917392\"; // String | Globally unique identifier for the time tracking entry.\nlet opts = { \n    'opt_fields': \"approval_status,assignee,assignee.name,attributable_to,attributable_to.name,attributable_to.resource_subtype,billable_status,categories,categories.color,categories.name,created_at,created_by,created_by.name,description,duration_minutes,entered_on,task,task.created_by,task.name,task.resource_subtype\"\n};\ntimeTrackingEntriesApiInstance.updateTimeTrackingEntry(body, time_tracking_entry_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.timetrackingentries.updateTimeTrackingEntry(timeTrackingEntryGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntime_tracking_entries_api_instance = asana.TimeTrackingEntriesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The updated fields for the time tracking entry.\ntime_tracking_entry_gid = \"917392\" # str | Globally unique identifier for the time tracking entry.\nopts = {\n    'opt_fields': \"approval_status,assignee,assignee.name,attributable_to,attributable_to.name,attributable_to.resource_subtype,billable_status,categories,categories.color,categories.name,created_at,created_by,created_by.name,description,duration_minutes,entered_on,task,task.created_by,task.name,task.resource_subtype\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Update a time tracking entry\n    api_response = time_tracking_entries_api_instance.update_time_tracking_entry(body, time_tracking_entry_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TimeTrackingEntriesApi->update_time_tracking_entry: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.time_tracking_entries.update_time_tracking_entry(time_tracking_entry_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            }
          ]
        }
      }
    },
    "/timesheet_approval_statuses": {
      "get": {
        "description": "<b>Required scope: </b><code>timesheet_approval_statuses:read</code>\n\nReturns a list of timesheet approval statuses filtered by workspace and optionally by user, date range, or approval status.",
        "operationId": "getTimesheetApprovalStatuses",
        "parameters": [
          {
            "description": "Globally unique identifier for the workspace.",
            "example": "12345",
            "in": "query",
            "name": "workspace",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Globally unique identifier for the user to filter timesheet approval statuses by.",
            "example": "67890",
            "in": "query",
            "name": "user",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The start date for filtering timesheet approval statuses.",
            "example": "2025-11-01",
            "in": "query",
            "name": "from_date",
            "schema": {
              "format": "date",
              "type": "string"
            }
          },
          {
            "description": "The end date for filtering timesheet approval statuses.",
            "example": "2025-11-30",
            "in": "query",
            "name": "to_date",
            "schema": {
              "format": "date",
              "type": "string"
            }
          },
          {
            "description": "Filter by approval status. Can be one or more of draft, submitted, approved, or rejected.",
            "example": "draft",
            "in": "query",
            "name": "approval_statuses",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "approval_status",
              "created_at",
              "end_date",
              "offset",
              "path",
              "start_date",
              "uri",
              "user",
              "user.name",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "approval_status",
                  "created_at",
                  "end_date",
                  "offset",
                  "path",
                  "start_date",
                  "uri",
                  "user",
                  "user.name",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TimesheetApprovalStatusCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TimesheetApprovalStatusResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested timesheet approval statuses."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "timesheet_approval_statuses:read"
            ]
          }
        ],
        "summary": "Get multiple timesheet approval statuses",
        "tags": [
          "Timesheet approval statuses"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1timesheet_approval_statuses/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet timesheetApprovalStatusesApiInstance = new Asana.TimesheetApprovalStatusesApi(client);\nlet workspace = \"12345\"; // String | Globally unique identifier for the workspace.\nlet opts = { \n    'user': \"67890\", \n    'from_date': \"2025-11-01\", \n    'to_date': \"2025-11-30\", \n    'approval_statuses': \"draft\", \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"approval_status,created_at,end_date,offset,path,start_date,uri,user,user.name,workspace,workspace.name\"\n};\ntimesheetApprovalStatusesApiInstance.getTimesheetApprovalStatuses(workspace, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ntimesheet_approval_statuses_api_instance = asana.TimesheetApprovalStatusesApi(api_client)\nworkspace = \"12345\" # str | Globally unique identifier for the workspace.\nopts = {\n    'user': \"67890\", # str | Globally unique identifier for the user to filter timesheet approval statuses by.\n    'from_date': '2025-11-01', # date | The start date for filtering timesheet approval statuses.\n    'to_date': '2025-11-30', # date | The end date for filtering timesheet approval statuses.\n    'approval_statuses': \"draft\", # str | Filter by approval status. Can be one or more of draft, submitted, approved, or rejected.\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    'opt_fields': \"approval_status,created_at,end_date,offset,path,start_date,uri,user,user.name,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get multiple timesheet approval statuses\n    api_response = timesheet_approval_statuses_api_instance.get_timesheet_approval_statuses(workspace, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TimesheetApprovalStatusesApi->get_timesheet_approval_statuses: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>timesheet_approval_statuses:write</code>\n\nCreates a new timesheet approval status for a user's timesheet week. The start_date must be a Monday or Sunday, and end_date must be the last day of that week (Sunday for a Monday start, Saturday for a Sunday start).\nReturns the created timesheet approval status record.",
        "operationId": "createTimesheetApprovalStatus",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "approval_status",
              "created_at",
              "end_date",
              "start_date",
              "user",
              "user.name",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "approval_status",
                  "created_at",
                  "end_date",
                  "start_date",
                  "user",
                  "user.name",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/CreateTimesheetApprovalStatusRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The timesheet approval status to create.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TimesheetApprovalStatusResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TimesheetApprovalStatusResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created a timesheet approval status."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "timesheet_approval_statuses:write"
            ]
          }
        ],
        "summary": "Create a timesheet approval status",
        "tags": [
          "Timesheet approval statuses"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1timesheet_approval_statuses/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet timesheetApprovalStatusesApiInstance = new Asana.TimesheetApprovalStatusesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The timesheet approval status to create.\nlet opts = { \n    'opt_fields': \"approval_status,created_at,end_date,start_date,user,user.name,workspace,workspace.name\"\n};\ntimesheetApprovalStatusesApiInstance.createTimesheetApprovalStatus(body, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ntimesheet_approval_statuses_api_instance = asana.TimesheetApprovalStatusesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The timesheet approval status to create.\nopts = {\n    'opt_fields': \"approval_status,created_at,end_date,start_date,user,user.name,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create a timesheet approval status\n    api_response = timesheet_approval_statuses_api_instance.create_timesheet_approval_status(body, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TimesheetApprovalStatusesApi->create_timesheet_approval_status: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/timesheet_approval_statuses/{timesheet_approval_status_gid}": {
      "get": {
        "description": "<b>Required scope: </b><code>timesheet_approval_statuses:read</code>\n\nReturns the complete timesheet approval status record for a single timesheet approval status.",
        "operationId": "getTimesheetApprovalStatus",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "approval_status",
              "created_at",
              "end_date",
              "start_date",
              "user",
              "user.name",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "approval_status",
                  "created_at",
                  "end_date",
                  "start_date",
                  "user",
                  "user.name",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TimesheetApprovalStatusResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TimesheetApprovalStatusResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested timesheet approval status."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "timesheet_approval_statuses:read"
            ]
          }
        ],
        "summary": "Get a timesheet approval status",
        "tags": [
          "Timesheet approval statuses"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1timesheet_approval_statuses~1{timesheet_approval_status_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet timesheetApprovalStatusesApiInstance = new Asana.TimesheetApprovalStatusesApi(client);\nlet timesheet_approval_status_gid = \"917392\"; // String | Globally unique identifier for the timesheet approval status.\nlet opts = { \n    'opt_fields': \"approval_status,created_at,end_date,start_date,user,user.name,workspace,workspace.name\"\n};\ntimesheetApprovalStatusesApiInstance.getTimesheetApprovalStatus(timesheet_approval_status_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ntimesheet_approval_statuses_api_instance = asana.TimesheetApprovalStatusesApi(api_client)\ntimesheet_approval_status_gid = \"917392\" # str | Globally unique identifier for the timesheet approval status.\nopts = {\n    'opt_fields': \"approval_status,created_at,end_date,start_date,user,user.name,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a timesheet approval status\n    api_response = timesheet_approval_statuses_api_instance.get_timesheet_approval_status(timesheet_approval_status_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TimesheetApprovalStatusesApi->get_timesheet_approval_status: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/timesheet_approval_status_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "put": {
        "description": "<b>Required scope: </b><code>timesheet_approval_statuses:write</code>\n\nUpdates the approval status of a timesheet approval status. The update supports state transitions such as submitting, recalling submission, approving, and rejecting. Only the fields provided in the `data` block will be updated; any unspecified fields will remain unchanged. Invalid transitions will result in a 400 error.",
        "operationId": "updateTimesheetApprovalStatus",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "approval_status",
              "created_at",
              "end_date",
              "start_date",
              "user",
              "user.name",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "approval_status",
                  "created_at",
                  "end_date",
                  "start_date",
                  "user",
                  "user.name",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/UpdateTimesheetApprovalStatusRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The fields to update on the timesheet approval status.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TimesheetApprovalStatusResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TimesheetApprovalStatusResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully updated the requested timesheet approval status."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "timesheet_approval_statuses:write"
            ]
          }
        ],
        "summary": "Update a timesheet approval status",
        "tags": [
          "Timesheet approval statuses"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1timesheet_approval_statuses~1{timesheet_approval_status_gid}/put",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet timesheetApprovalStatusesApiInstance = new Asana.TimesheetApprovalStatusesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The fields to update on the timesheet approval status.\nlet timesheet_approval_status_gid = \"917392\"; // String | Globally unique identifier for the timesheet approval status.\nlet opts = { \n    'opt_fields': \"approval_status,created_at,end_date,start_date,user,user.name,workspace,workspace.name\"\n};\ntimesheetApprovalStatusesApiInstance.updateTimesheetApprovalStatus(body, timesheet_approval_status_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ntimesheet_approval_statuses_api_instance = asana.TimesheetApprovalStatusesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The fields to update on the timesheet approval status.\ntimesheet_approval_status_gid = \"917392\" # str | Globally unique identifier for the timesheet approval status.\nopts = {\n    'opt_fields': \"approval_status,created_at,end_date,start_date,user,user.name,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Update a timesheet approval status\n    api_response = timesheet_approval_statuses_api_instance.update_timesheet_approval_status(body, timesheet_approval_status_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TimesheetApprovalStatusesApi->update_timesheet_approval_status: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/user_task_lists/{user_task_list_gid}": {
      "get": {
        "description": "<b>Required scope: </b><code>tasks:read</code>\n\nReturns the full record for a user task list.",
        "operationId": "getUserTaskList",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "name",
              "owner",
              "workspace"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "name",
                  "owner",
                  "workspace"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/UserTaskListResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__UserTaskListResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the user task list."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:read"
            ]
          }
        ],
        "summary": "Get a user task list",
        "tags": [
          "User task lists"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1user_task_lists~1{user_task_list_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nUserTaskList result = client.usertasklists.getUserTaskList(userTaskListGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet userTaskListsApiInstance = new Asana.UserTaskListsApi(client);\nlet user_task_list_gid = \"12345\"; // String | Globally unique identifier for the user task list.\nlet opts = { \n    'opt_fields': \"name,owner,workspace\"\n};\nuserTaskListsApiInstance.getUserTaskList(user_task_list_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.usertasklists.getUserTaskList(userTaskListGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nuser_task_lists_api_instance = asana.UserTaskListsApi(api_client)\nuser_task_list_gid = \"12345\" # str | Globally unique identifier for the user task list.\nopts = {\n    'opt_fields': \"name,owner,workspace\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a user task list\n    api_response = user_task_lists_api_instance.get_user_task_list(user_task_list_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling UserTaskListsApi->get_user_task_list: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.user_task_lists.get_user_task_list(user_task_list_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->usertasklists->getUserTaskList($user_task_list_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.user_task_lists.get_user_task_list(user_task_list_gid: 'user_task_list_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/user_task_list_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/user_task_lists/{user_task_list_gid}/tasks": {
      "get": {
        "description": "<b>Required scope: </b><code>tasks:read</code>\n\nReturns the compact list of tasks in a user’s My Tasks list.\n*Note: Access control is enforced for this endpoint as with all Asana API endpoints, meaning a user’s private tasks will be filtered out if the API-authenticated user does not have access to them.*\n*Note: Both complete and incomplete tasks are returned by default unless they are filtered out (for example, setting `completed_since=now` will return only incomplete tasks, which is the default view for “My Tasks” in Asana.)*",
        "operationId": "getTasksForUserTaskList",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "actual_time_minutes",
              "approval_status",
              "assigned_by",
              "assigned_by.name",
              "assignee",
              "assignee.name",
              "assignee_section",
              "assignee_section.name",
              "assignee_status",
              "completed",
              "completed_at",
              "completed_by",
              "completed_by.name",
              "created_at",
              "created_by",
              "custom_fields",
              "custom_fields.asana_created_field",
              "custom_fields.created_by",
              "custom_fields.created_by.name",
              "custom_fields.currency_code",
              "custom_fields.custom_label",
              "custom_fields.custom_label_position",
              "custom_fields.date_value",
              "custom_fields.date_value.date",
              "custom_fields.date_value.date_time",
              "custom_fields.default_access_level",
              "custom_fields.description",
              "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.format",
              "custom_fields.has_notifications_enabled",
              "custom_fields.html_text_value",
              "custom_fields.id_prefix",
              "custom_fields.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_global_to_workspace",
              "custom_fields.is_lookup_field",
              "custom_fields.is_value_read_only",
              "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.people_value",
              "custom_fields.people_value.name",
              "custom_fields.precision",
              "custom_fields.privacy_setting",
              "custom_fields.reference_value",
              "custom_fields.reference_value.name",
              "custom_fields.representation_type",
              "custom_fields.resource_subtype",
              "custom_fields.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "custom_type_status_option",
              "custom_type_status_option.name",
              "dependencies",
              "dependents",
              "due_at",
              "due_on",
              "effective_memberships",
              "external",
              "external.data",
              "followers",
              "followers.name",
              "has_subtasks_date_mismatch",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_notes",
              "is_rendered_as_separator",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "memberships",
              "memberships.project",
              "memberships.project.name",
              "memberships.project.resource_subtype",
              "memberships.section",
              "memberships.section.name",
              "modified_at",
              "name",
              "notes",
              "num_hearts",
              "num_likes",
              "num_subtasks",
              "offset",
              "parent",
              "parent.created_by",
              "parent.name",
              "parent.resource_subtype",
              "path",
              "permalink_url",
              "projects",
              "projects.name",
              "projects.resource_subtype",
              "resource_subtype",
              "start_at",
              "start_on",
              "tags",
              "tags.name",
              "uri",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "actual_time_minutes",
                  "approval_status",
                  "assigned_by",
                  "assigned_by.name",
                  "assignee",
                  "assignee.name",
                  "assignee_section",
                  "assignee_section.name",
                  "assignee_status",
                  "completed",
                  "completed_at",
                  "completed_by",
                  "completed_by.name",
                  "created_at",
                  "created_by",
                  "custom_fields",
                  "custom_fields.asana_created_field",
                  "custom_fields.created_by",
                  "custom_fields.created_by.name",
                  "custom_fields.currency_code",
                  "custom_fields.custom_label",
                  "custom_fields.custom_label_position",
                  "custom_fields.date_value",
                  "custom_fields.date_value.date",
                  "custom_fields.date_value.date_time",
                  "custom_fields.default_access_level",
                  "custom_fields.description",
                  "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.format",
                  "custom_fields.has_notifications_enabled",
                  "custom_fields.html_text_value",
                  "custom_fields.id_prefix",
                  "custom_fields.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_global_to_workspace",
                  "custom_fields.is_lookup_field",
                  "custom_fields.is_value_read_only",
                  "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.people_value",
                  "custom_fields.people_value.name",
                  "custom_fields.precision",
                  "custom_fields.privacy_setting",
                  "custom_fields.reference_value",
                  "custom_fields.reference_value.name",
                  "custom_fields.representation_type",
                  "custom_fields.resource_subtype",
                  "custom_fields.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "custom_type_status_option",
                  "custom_type_status_option.name",
                  "dependencies",
                  "dependents",
                  "due_at",
                  "due_on",
                  "effective_memberships",
                  "external",
                  "external.data",
                  "followers",
                  "followers.name",
                  "has_subtasks_date_mismatch",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_notes",
                  "is_rendered_as_separator",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "memberships",
                  "memberships.project",
                  "memberships.project.name",
                  "memberships.project.resource_subtype",
                  "memberships.section",
                  "memberships.section.name",
                  "modified_at",
                  "name",
                  "notes",
                  "num_hearts",
                  "num_likes",
                  "num_subtasks",
                  "offset",
                  "parent",
                  "parent.created_by",
                  "parent.name",
                  "parent.resource_subtype",
                  "path",
                  "permalink_url",
                  "projects",
                  "projects.name",
                  "projects.resource_subtype",
                  "resource_subtype",
                  "start_at",
                  "start_on",
                  "tags",
                  "tags.name",
                  "uri",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TaskCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TaskResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the user task list's tasks."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:read"
            ]
          }
        ],
        "summary": "Get tasks from a user task list",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1user_task_lists~1{user_task_list_gid}~1tasks/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Task> result = client.tasks.getTasksForUserTaskList(userTaskListGid, completedSince)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet user_task_list_gid = \"12345\"; // String | Globally unique identifier for the user task list.\nlet opts = { \n    'completed_since': \"2012-02-22T02:06:58.158Z\", \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,offset,parent,parent.created_by,parent.name,parent.resource_subtype,path,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,uri,workspace,workspace.name\"\n};\ntasksApiInstance.getTasksForUserTaskList(user_task_list_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.getTasksForUserTaskList(userTaskListGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\nuser_task_list_gid = \"12345\" # str | Globally unique identifier for the user task list.\nopts = {\n    'completed_since': \"2012-02-22T02:06:58.158Z\", # str | Only return tasks that are either incomplete or that have been completed since this time. Accepts a date-time string or the keyword *now*. \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    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,offset,parent,parent.created_by,parent.name,parent.resource_subtype,path,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,uri,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get tasks from a user task list\n    api_response = tasks_api_instance.get_tasks_for_user_task_list(user_task_list_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->get_tasks_for_user_task_list: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.get_tasks_for_user_task_list(user_task_list_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->getTasksForUserTaskList($user_task_list_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.get_tasks_for_user_task_list(user_task_list_gid: 'user_task_list_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/completed_since"
        },
        {
          "$ref": "#/components/parameters/user_task_list_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/users": {
      "get": {
        "description": "<b>Required scope: </b><code>users:read</code>\n\nReturns the user records for all users in all workspaces and organizations accessible to the authenticated user. Accepts an optional workspace ID parameter.\nResults are sorted by user ID.",
        "operationId": "getUsers",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "email",
              "name",
              "offset",
              "path",
              "photo",
              "photo.image_1024x1024",
              "photo.image_128x128",
              "photo.image_21x21",
              "photo.image_27x27",
              "photo.image_36x36",
              "photo.image_60x60",
              "uri",
              "workspaces",
              "workspaces.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "email",
                  "name",
                  "offset",
                  "path",
                  "photo",
                  "photo.image_1024x1024",
                  "photo.image_128x128",
                  "photo.image_21x21",
                  "photo.image_27x27",
                  "photo.image_36x36",
                  "photo.image_60x60",
                  "uri",
                  "workspaces",
                  "workspaces.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/UserCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__UserResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested user records."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "users:read"
            ]
          }
        ],
        "summary": "Get multiple users",
        "tags": [
          "Users"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1users/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<User> result = client.users.getUsers(team, workspace)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet usersApiInstance = new Asana.UsersApi(client);\nlet opts = { \n    'workspace': \"1331\", \n    'team': \"15627\", \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,email,name,offset,path,photo,photo.image_1024x1024,photo.image_128x128,photo.image_21x21,photo.image_27x27,photo.image_36x36,photo.image_60x60,uri,workspaces,workspaces.name\"\n};\nusersApiInstance.getUsers(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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.users.getUsers({param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nusers_api_instance = asana.UsersApi(api_client)\nopts = {\n    'workspace': \"1331\", # str | The workspace or organization ID to filter users on.\n    'team': \"15627\", # str | The team ID to filter users on.\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    'opt_fields': \"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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,email,name,offset,path,photo,photo.image_1024x1024,photo.image_128x128,photo.image_21x21,photo.image_27x27,photo.image_36x36,photo.image_60x60,uri,workspaces,workspaces.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get multiple users\n    api_response = users_api_instance.get_users(opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling UsersApi->get_users: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.users.get_users({'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->users->getUsers(array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.users.get_users(param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "description": "The workspace or organization ID to filter users on.",
          "example": "1331",
          "in": "query",
          "name": "workspace",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "The team ID to filter users on.",
          "example": "15627",
          "in": "query",
          "name": "team",
          "schema": {
            "type": "string"
          }
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/users/{user_gid}": {
      "get": {
        "description": "<b>Required scope: </b><code>users:read</code>\n\nReturns the full user record for the single user with the provided ID.",
        "operationId": "getUser",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "email",
              "name",
              "photo",
              "photo.image_1024x1024",
              "photo.image_128x128",
              "photo.image_21x21",
              "photo.image_27x27",
              "photo.image_36x36",
              "photo.image_60x60",
              "workspaces",
              "workspaces.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "email",
                  "name",
                  "photo",
                  "photo.image_1024x1024",
                  "photo.image_128x128",
                  "photo.image_21x21",
                  "photo.image_27x27",
                  "photo.image_36x36",
                  "photo.image_60x60",
                  "workspaces",
                  "workspaces.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/UserResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__UserResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Returns the user specified."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "users:read"
            ]
          }
        ],
        "summary": "Get a user",
        "tags": [
          "Users"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1users~1{user_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nUser result = client.users.getUser(userGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet usersApiInstance = new Asana.UsersApi(client);\nlet user_gid = \"me\"; // String | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nlet opts = { \n    'workspace': \"12345\", \n    'opt_fields': \"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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,email,name,photo,photo.image_1024x1024,photo.image_128x128,photo.image_21x21,photo.image_27x27,photo.image_36x36,photo.image_60x60,workspaces,workspaces.name\"\n};\nusersApiInstance.getUser(user_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.users.getUser(userGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nusers_api_instance = asana.UsersApi(api_client)\nuser_gid = \"me\" # str | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nopts = {\n    'workspace': \"12345\", # str | The workspace to filter results on.\n    'opt_fields': \"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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,email,name,photo,photo.image_1024x1024,photo.image_128x128,photo.image_21x21,photo.image_27x27,photo.image_36x36,photo.image_60x60,workspaces,workspaces.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a user\n    api_response = users_api_instance.get_user(user_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling UsersApi->get_user: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.users.get_user(user_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->users->getUser($user_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.users.get_user(user_gid: 'user_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/user_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/workspace_query_param"
        }
      ],
      "put": {
        "description": "A specific, existing user can be updated by making a PUT request on the\nURL for that user. Only the fields provided in the `data` block will be\nupdated; any unspecified fields will remain unchanged.\n\nReturns the complete updated user record.",
        "operationId": "updateUser",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "email",
              "name",
              "photo",
              "photo.image_1024x1024",
              "photo.image_128x128",
              "photo.image_21x21",
              "photo.image_27x27",
              "photo.image_36x36",
              "photo.image_60x60",
              "workspaces",
              "workspaces.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "email",
                  "name",
                  "photo",
                  "photo.image_1024x1024",
                  "photo.image_128x128",
                  "photo.image_21x21",
                  "photo.image_27x27",
                  "photo.image_36x36",
                  "photo.image_60x60",
                  "workspaces",
                  "workspaces.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/UserUpdateRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The user to update.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/UserResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__UserResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully updated the specified user."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Update a user",
        "tags": [
          "Users"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1users~1{user_gid}/put",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet usersApiInstance = new Asana.UsersApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The user to update.\nlet user_gid = \"me\"; // String | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nlet opts = { \n    'workspace': \"12345\", \n    'opt_fields': \"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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,email,name,photo,photo.image_1024x1024,photo.image_128x128,photo.image_21x21,photo.image_27x27,photo.image_36x36,photo.image_60x60,workspaces,workspaces.name\"\n};\nusersApiInstance.updateUser(body, user_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nusers_api_instance = asana.UsersApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The user to update.\nuser_gid = \"me\" # str | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nopts = {\n    'workspace': \"12345\", # str | The workspace to filter results on.\n    'opt_fields': \"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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,email,name,photo,photo.image_1024x1024,photo.image_128x128,photo.image_21x21,photo.image_27x27,photo.image_36x36,photo.image_60x60,workspaces,workspaces.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Update a user\n    api_response = users_api_instance.update_user(body, user_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling UsersApi->update_user: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/users/{user_gid}/favorites": {
      "get": {
        "description": "<b>Required scope: </b><code>users:read</code>\n\nReturns all of a user's favorites within a specified workspace and of a given type. The results are ordered exactly as they appear in the user's Asana sidebar in the web application. Note that this endpoint currently only returns favorites for the current user (i.e., the user associated with the authentication token).",
        "operationId": "getFavoritesForUser",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "name",
              "offset",
              "path",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "name",
                  "offset",
                  "path",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/AsanaNamedResource"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__AsanaNamedResourceArray"
                    }
                  ]
                }
              }
            },
            "description": "Returns the specified user's favorites."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "users:read"
            ]
          }
        ],
        "summary": "Get a user's favorites",
        "tags": [
          "Users"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1users~1{user_gid}~1favorites/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<JsonElement> result = client.users.getFavoritesForUser(userGid, workspace, resourceType)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet usersApiInstance = new Asana.UsersApi(client);\nlet user_gid = \"me\"; // String | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nlet resource_type = \"project\"; // String | The resource type of favorites to be returned.\nlet workspace = \"1234\"; // String | The workspace in which to get favorites.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"name,offset,path,uri\"\n};\nusersApiInstance.getFavoritesForUser(user_gid, resource_type, workspace, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.users.getFavoritesForUser(userGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nusers_api_instance = asana.UsersApi(api_client)\nuser_gid = \"me\" # str | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nresource_type = \"project\" # str | The resource type of favorites to be returned.\nworkspace = \"1234\" # str | The workspace in which to get favorites.\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    'opt_fields': \"name,offset,path,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a user's favorites\n    api_response = users_api_instance.get_favorites_for_user(user_gid, resource_type, workspace, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling UsersApi->get_favorites_for_user: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.users.get_favorites_for_user(user_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->users->getFavoritesForUser($user_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.users.get_favorites_for_user(user_gid: 'user_gid', resource_type: '&#x27;resource_type_example&#x27;', workspace: '&#x27;workspace_example&#x27;', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/user_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        },
        {
          "description": "The resource type of favorites to be returned.",
          "in": "query",
          "name": "resource_type",
          "required": true,
          "schema": {
            "default": "project",
            "enum": [
              "portfolio",
              "project",
              "tag",
              "task",
              "user",
              "project_template"
            ],
            "type": "string"
          }
        },
        {
          "description": "The workspace in which to get favorites.",
          "example": "1234",
          "in": "query",
          "name": "workspace",
          "required": true,
          "schema": {
            "type": "string"
          }
        }
      ]
    },
    "/users/{user_gid}/notifications": {
      "get": {
        "description": "<b>Required scope: </b><code>notifications:read</code>\n\nReturns a paginated collection of active, unarchived notifications for the current user in newest-first Inbox order. A user may only list their own notifications. The default page size is 50 notifications.",
        "operationId": "getNotificationsForUser",
        "parameters": [
          {
            "description": "GID of the workspace from which to return notifications.",
            "example": "31326",
            "in": "query",
            "name": "workspace",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_at",
              "created_by",
              "created_by.name",
              "is_read",
              "offset",
              "path",
              "priority_classification",
              "story",
              "story_resource_subtype",
              "uri",
              "work_objects",
              "work_objects.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "is_read",
                  "offset",
                  "path",
                  "priority_classification",
                  "story",
                  "story_resource_subtype",
                  "uri",
                  "work_objects",
                  "work_objects.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/NotificationResponse"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__NotificationResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested notifications."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "notifications:read"
            ]
          }
        ],
        "summary": "Get notifications for a user",
        "tags": [
          "Notifications"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1users~1{user_gid}~1notifications/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet notificationsApiInstance = new Asana.NotificationsApi(client);\nlet user_gid = \"me\"; // String | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nlet workspace = \"31326\"; // String | GID of the workspace from which to return notifications.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"created_at,created_by,created_by.name,is_read,offset,path,priority_classification,story,story_resource_subtype,uri,work_objects,work_objects.name\"\n};\nnotificationsApiInstance.getNotificationsForUser(user_gid, workspace, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nnotifications_api_instance = asana.NotificationsApi(api_client)\nuser_gid = \"me\" # str | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nworkspace = \"31326\" # str | GID of the workspace from which to return notifications.\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    'opt_fields': \"created_at,created_by,created_by.name,is_read,offset,path,priority_classification,story,story_resource_subtype,uri,work_objects,work_objects.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get notifications for a user\n    api_response = notifications_api_instance.get_notifications_for_user(user_gid, workspace, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling NotificationsApi->get_notifications_for_user: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/user_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/users/{user_gid}/notifications/markRead": {
      "parameters": [
        {
          "$ref": "#/components/parameters/user_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>notifications:write</code>\n\nMarks only the given notifications as read for the authenticated user. A user may only mark their own notifications. GIDs that don't exist, don't belong to the caller, or have been deleted are reported in failed_gids rather than failing the whole request.",
        "operationId": "markNotificationsReadForUser",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "failed_gids"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "failed_gids"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/MarkNotificationsRequest"
                  }
                },
                "required": [
                  "data"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/MarkNotificationsResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__MarkNotificationsResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully processed the request. Check failed_gids for any notifications that could not be updated."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "notifications:write"
            ]
          }
        ],
        "summary": "Mark notifications as read",
        "tags": [
          "Notifications"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1users~1{user_gid}~1notifications~1markRead/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet notificationsApiInstance = new Asana.NotificationsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | \nlet user_gid = \"me\"; // String | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nlet opts = { \n    'opt_fields': \"failed_gids\"\n};\nnotificationsApiInstance.markNotificationsReadForUser(body, user_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nnotifications_api_instance = asana.NotificationsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | \nuser_gid = \"me\" # str | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nopts = {\n    'opt_fields': \"failed_gids\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Mark notifications as read\n    api_response = notifications_api_instance.mark_notifications_read_for_user(body, user_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling NotificationsApi->mark_notifications_read_for_user: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/users/{user_gid}/notifications/markUnread": {
      "parameters": [
        {
          "$ref": "#/components/parameters/user_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>notifications:write</code>\n\nMarks only the given notifications as unread for the authenticated user. A notification that is archived is also unarchived and moves to the top of Inbox, matching the Inbox UI's unarchive action. Notifications already in Inbox keep their existing position. A user may only mark their own notifications. GIDs that don't exist, don't belong to the caller, or have been deleted are reported in failed_gids rather than failing the whole request.",
        "operationId": "markNotificationsUnreadForUser",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "failed_gids"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "failed_gids"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/MarkNotificationsRequest"
                  }
                },
                "required": [
                  "data"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/MarkNotificationsResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__MarkNotificationsResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully processed the request. Check failed_gids for any notifications that could not be updated."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "notifications:write"
            ]
          }
        ],
        "summary": "Mark notifications as unread",
        "tags": [
          "Notifications"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1users~1{user_gid}~1notifications~1markUnread/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet notificationsApiInstance = new Asana.NotificationsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | \nlet user_gid = \"me\"; // String | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nlet opts = { \n    'opt_fields': \"failed_gids\"\n};\nnotificationsApiInstance.markNotificationsUnreadForUser(body, user_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nnotifications_api_instance = asana.NotificationsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | \nuser_gid = \"me\" # str | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nopts = {\n    'opt_fields': \"failed_gids\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Mark notifications as unread\n    api_response = notifications_api_instance.mark_notifications_unread_for_user(body, user_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling NotificationsApi->mark_notifications_unread_for_user: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/users/{user_gid}/team_memberships": {
      "get": {
        "description": "<b>Required scope: </b><code>team_memberships:read</code>\n\nReturns the compact team membership records for the user.",
        "operationId": "getTeamMembershipsForUser",
        "parameters": [
          {
            "description": "Globally unique identifier for the workspace.",
            "example": "31326",
            "in": "query",
            "name": "workspace",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "is_admin",
              "is_guest",
              "is_limited_access",
              "offset",
              "path",
              "team",
              "team.name",
              "uri",
              "user",
              "user.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "is_admin",
                  "is_guest",
                  "is_limited_access",
                  "offset",
                  "path",
                  "team",
                  "team.name",
                  "uri",
                  "user",
                  "user.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TeamMembershipCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TeamMembershipResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested users's memberships."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "team_memberships:read"
            ]
          }
        ],
        "summary": "Get memberships from a user",
        "tags": [
          "Team memberships"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1users~1{user_gid}~1team_memberships/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<JsonElement> result = client.teammemberships.getTeamMembershipsForUser(userGid, workspace)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet teamMembershipsApiInstance = new Asana.TeamMembershipsApi(client);\nlet user_gid = \"me\"; // String | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nlet workspace = \"31326\"; // String | Globally unique identifier for the workspace.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"is_admin,is_guest,is_limited_access,offset,path,team,team.name,uri,user,user.name\"\n};\nteamMembershipsApiInstance.getTeamMembershipsForUser(user_gid, workspace, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.teammemberships.getTeamMembershipsForUser(userGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nteam_memberships_api_instance = asana.TeamMembershipsApi(api_client)\nuser_gid = \"me\" # str | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nworkspace = \"31326\" # str | Globally unique identifier for the workspace.\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    'opt_fields': \"is_admin,is_guest,is_limited_access,offset,path,team,team.name,uri,user,user.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get memberships from a user\n    api_response = team_memberships_api_instance.get_team_memberships_for_user(user_gid, workspace, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TeamMembershipsApi->get_team_memberships_for_user: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.team_memberships.get_team_memberships_for_user(user_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->teammemberships->getTeamMembershipsForUser($user_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.team_memberships.get_team_memberships_for_user(user_gid: 'user_gid', workspace: '&#x27;workspace_example&#x27;', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/user_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/users/{user_gid}/teams": {
      "get": {
        "description": "<b>Required scope: </b><code>teams:read</code>\n\nReturns the compact records for all teams to which the given user is assigned.",
        "operationId": "getTeamsForUser",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "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.default_access_level",
              "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.html_text_value",
              "custom_field_settings.custom_field.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_global_to_workspace",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.privacy_setting",
              "custom_field_settings.custom_field.reference_value",
              "custom_field_settings.custom_field.reference_value.name",
              "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.parent.resource_subtype",
              "custom_field_settings.project",
              "custom_field_settings.project.name",
              "custom_field_settings.project.resource_subtype",
              "description",
              "edit_team_name_or_description_access_level",
              "edit_team_visibility_or_trash_team_access_level",
              "endorsed",
              "guest_invite_management_access_level",
              "html_description",
              "join_request_management_access_level",
              "member_invite_management_access_level",
              "name",
              "offset",
              "organization",
              "organization.name",
              "path",
              "permalink_url",
              "team_content_management_access_level",
              "team_member_removal_access_level",
              "uri",
              "visibility"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "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.default_access_level",
                  "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.html_text_value",
                  "custom_field_settings.custom_field.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_global_to_workspace",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.privacy_setting",
                  "custom_field_settings.custom_field.reference_value",
                  "custom_field_settings.custom_field.reference_value.name",
                  "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.parent.resource_subtype",
                  "custom_field_settings.project",
                  "custom_field_settings.project.name",
                  "custom_field_settings.project.resource_subtype",
                  "description",
                  "edit_team_name_or_description_access_level",
                  "edit_team_visibility_or_trash_team_access_level",
                  "endorsed",
                  "guest_invite_management_access_level",
                  "html_description",
                  "join_request_management_access_level",
                  "member_invite_management_access_level",
                  "name",
                  "offset",
                  "organization",
                  "organization.name",
                  "path",
                  "permalink_url",
                  "team_content_management_access_level",
                  "team_member_removal_access_level",
                  "uri",
                  "visibility"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TeamCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TeamResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Returns the team records for all teams in the organization or workspace to which the given user is assigned."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "teams:read"
            ]
          }
        ],
        "summary": "Get teams for a user",
        "tags": [
          "Teams"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1users~1{user_gid}~1teams/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Team> result = client.teams.getTeamsForUser(userGid, organization)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet teamsApiInstance = new Asana.TeamsApi(client);\nlet user_gid = \"me\"; // String | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nlet organization = \"1331\"; // String | The workspace or organization to filter teams on.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,description,edit_team_name_or_description_access_level,edit_team_visibility_or_trash_team_access_level,endorsed,guest_invite_management_access_level,html_description,join_request_management_access_level,member_invite_management_access_level,name,offset,organization,organization.name,path,permalink_url,team_content_management_access_level,team_member_removal_access_level,uri,visibility\"\n};\nteamsApiInstance.getTeamsForUser(user_gid, organization, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.teams.getTeamsForUser(userGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nteams_api_instance = asana.TeamsApi(api_client)\nuser_gid = \"me\" # str | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\norganization = \"1331\" # str | The workspace or organization to filter teams on.\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    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,description,edit_team_name_or_description_access_level,edit_team_visibility_or_trash_team_access_level,endorsed,guest_invite_management_access_level,html_description,join_request_management_access_level,member_invite_management_access_level,name,offset,organization,organization.name,path,permalink_url,team_content_management_access_level,team_member_removal_access_level,uri,visibility\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get teams for a user\n    api_response = teams_api_instance.get_teams_for_user(user_gid, organization, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TeamsApi->get_teams_for_user: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.teams.get_teams_for_user(user_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->teams->getTeamsForUser($user_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.teams.get_teams_for_user(user_gid: 'user_gid', organization: '&#x27;organization_example&#x27;', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/user_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        },
        {
          "description": "The workspace or organization to filter teams on.",
          "example": "1331",
          "in": "query",
          "name": "organization",
          "required": true,
          "schema": {
            "type": "string"
          }
        }
      ]
    },
    "/users/{user_gid}/user_task_list": {
      "get": {
        "description": "<b>Required scope: </b><code>tasks:read</code>\n\nReturns the full record for a user's task list.",
        "operationId": "getUserTaskListForUser",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "name",
              "owner",
              "workspace"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "name",
                  "owner",
                  "workspace"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/UserTaskListResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__UserTaskListResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the user's task list."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:read"
            ]
          }
        ],
        "summary": "Get a user's task list",
        "tags": [
          "User task lists"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1users~1{user_gid}~1user_task_list/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nUserTaskList result = client.usertasklists.getUserTaskListForUser(userGid, workspace)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet userTaskListsApiInstance = new Asana.UserTaskListsApi(client);\nlet user_gid = \"me\"; // String | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nlet workspace = \"1234\"; // String | The workspace in which to get the user task list.\nlet opts = { \n    'opt_fields': \"name,owner,workspace\"\n};\nuserTaskListsApiInstance.getUserTaskListForUser(user_gid, workspace, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.usertasklists.getUserTaskListForUser(userGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nuser_task_lists_api_instance = asana.UserTaskListsApi(api_client)\nuser_gid = \"me\" # str | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nworkspace = \"1234\" # str | The workspace in which to get the user task list.\nopts = {\n    'opt_fields': \"name,owner,workspace\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a user's task list\n    api_response = user_task_lists_api_instance.get_user_task_list_for_user(user_gid, workspace, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling UserTaskListsApi->get_user_task_list_for_user: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.user_task_lists.get_user_task_list_for_user(user_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->usertasklists->getUserTaskListForUser($user_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.user_task_lists.get_user_task_list_for_user(user_gid: 'user_gid', workspace: '&#x27;workspace_example&#x27;', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/user_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "description": "The workspace in which to get the user task list.",
          "example": "1234",
          "in": "query",
          "name": "workspace",
          "required": true,
          "schema": {
            "type": "string"
          }
        }
      ]
    },
    "/users/{user_gid}/workspace_memberships": {
      "get": {
        "description": "Returns the compact workspace membership records for the user.",
        "operationId": "getWorkspaceMembershipsForUser",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_at",
              "is_active",
              "is_admin",
              "is_guest",
              "is_view_only",
              "offset",
              "path",
              "uri",
              "user",
              "user.name",
              "user_task_list",
              "user_task_list.name",
              "user_task_list.owner",
              "user_task_list.workspace",
              "vacation_dates",
              "vacation_dates.end_on",
              "vacation_dates.start_on",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_at",
                  "is_active",
                  "is_admin",
                  "is_guest",
                  "is_view_only",
                  "offset",
                  "path",
                  "uri",
                  "user",
                  "user.name",
                  "user_task_list",
                  "user_task_list.name",
                  "user_task_list.owner",
                  "user_task_list.workspace",
                  "vacation_dates",
                  "vacation_dates.end_on",
                  "vacation_dates.start_on",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/WorkspaceMembershipCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__WorkspaceMembershipResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested user's workspace memberships."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get workspace memberships for a user",
        "tags": [
          "Workspace memberships"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1users~1{user_gid}~1workspace_memberships/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<JsonElement> result = client.workspacememberships.getWorkspaceMembershipsForUser(userGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet workspaceMembershipsApiInstance = new Asana.WorkspaceMembershipsApi(client);\nlet user_gid = \"me\"; // String | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"created_at,is_active,is_admin,is_guest,is_view_only,offset,path,uri,user,user.name,user_task_list,user_task_list.name,user_task_list.owner,user_task_list.workspace,vacation_dates,vacation_dates.end_on,vacation_dates.start_on,workspace,workspace.name\"\n};\nworkspaceMembershipsApiInstance.getWorkspaceMembershipsForUser(user_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.workspacememberships.getWorkspaceMembershipsForUser(userGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nworkspace_memberships_api_instance = asana.WorkspaceMembershipsApi(api_client)\nuser_gid = \"me\" # str | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\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    'opt_fields': \"created_at,is_active,is_admin,is_guest,is_view_only,offset,path,uri,user,user.name,user_task_list,user_task_list.name,user_task_list.owner,user_task_list.workspace,vacation_dates,vacation_dates.end_on,vacation_dates.start_on,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get workspace memberships for a user\n    api_response = workspace_memberships_api_instance.get_workspace_memberships_for_user(user_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling WorkspaceMembershipsApi->get_workspace_memberships_for_user: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.workspace_memberships.get_workspace_memberships_for_user(user_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->workspacememberships->getWorkspaceMembershipsForUser($user_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.workspace_memberships.get_workspace_memberships_for_user(user_gid: 'user_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/user_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/webhooks": {
      "get": {
        "description": "<b>Required scope: </b><code>webhooks:read</code>\n\nGet the compact representation of all webhooks your app has registered for the authenticated user in the given workspace.",
        "operationId": "getWebhooks",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "The workspace to query for webhooks in.",
            "example": "1331",
            "in": "query",
            "name": "workspace",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Only return webhooks for the given resource.",
            "example": "51648",
            "in": "query",
            "name": "resource",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "active",
              "created_at",
              "delivery_retry_count",
              "failure_deletion_timestamp",
              "filters",
              "filters.action",
              "filters.fields",
              "filters.resource_subtype",
              "last_failure_at",
              "last_failure_content",
              "last_success_at",
              "next_attempt_after",
              "offset",
              "path",
              "resource",
              "resource.name",
              "target",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "active",
                  "created_at",
                  "delivery_retry_count",
                  "failure_deletion_timestamp",
                  "filters",
                  "filters.action",
                  "filters.fields",
                  "filters.resource_subtype",
                  "last_failure_at",
                  "last_failure_content",
                  "last_success_at",
                  "next_attempt_after",
                  "offset",
                  "path",
                  "resource",
                  "resource.name",
                  "target",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/WebhookResponse"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__WebhookResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested webhooks."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "webhooks:read"
            ]
          }
        ],
        "summary": "Get multiple webhooks",
        "tags": [
          "Webhooks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1webhooks/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Webhook> result = client.webhooks.getWebhooks(resource, workspace)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet webhooksApiInstance = new Asana.WebhooksApi(client);\nlet workspace = \"1331\"; // String | The workspace to query for webhooks in.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'resource': \"51648\", \n    'opt_fields': \"active,created_at,delivery_retry_count,failure_deletion_timestamp,filters,filters.action,filters.fields,filters.resource_subtype,last_failure_at,last_failure_content,last_success_at,next_attempt_after,offset,path,resource,resource.name,target,uri\"\n};\nwebhooksApiInstance.getWebhooks(workspace, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.webhooks.getWebhooks({param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nwebhooks_api_instance = asana.WebhooksApi(api_client)\nworkspace = \"1331\" # str | The workspace to query for webhooks in.\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    'resource': \"51648\", # str | Only return webhooks for the given resource.\n    'opt_fields': \"active,created_at,delivery_retry_count,failure_deletion_timestamp,filters,filters.action,filters.fields,filters.resource_subtype,last_failure_at,last_failure_content,last_success_at,next_attempt_after,offset,path,resource,resource.name,target,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get multiple webhooks\n    api_response = webhooks_api_instance.get_webhooks(workspace, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling WebhooksApi->get_webhooks: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.webhooks.get_webhooks({'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->webhooks->getWebhooks(array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.webhooks.get_webhooks(workspace: '&#x27;workspace_example&#x27;', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>webhooks:write</code>\n\nEstablishing a webhook is a two-part process. First, a simple HTTP POST\nrequest initiates the creation similar to creating any other resource.\n\nNext, in the middle of this request comes the confirmation handshake.\nWhen a webhook is created, we will send a test POST to the target with an\n`X-Hook-Secret` header. The target must respond with a `200 OK` or `204\nNo Content` and a matching `X-Hook-Secret` header to confirm that this\nwebhook subscription is indeed expected. We strongly recommend storing\nthis secret to be used to verify future webhook event signatures.\n\nThe POST request to create the webhook will then return with the status\nof the request. If you do not acknowledge the webhook’s confirmation\nhandshake it will fail to setup, and you will receive an error in\nresponse to your attempt to create it. This means you need to be able to\nreceive and complete the webhook *while* the POST request is in-flight\n(in other words, have a server that can handle requests asynchronously).\n\nInvalid hostnames like localhost will receive a 403 Forbidden status code.\n\n```\n# Request\ncurl -H \"Authorization: Bearer <personal_access_token>\" \\\n-X POST https://app.asana.com/api/1.0/webhooks \\\n-d \"resource=8675309\" \\\n-d \"target=https://example.com/receive-webhook/7654\"\n```\n\n```\n# Handshake sent to https://example.com/\nPOST /receive-webhook/7654\nX-Hook-Secret: b537207f20cbfa02357cf448134da559e8bd39d61597dcd5631b8012eae53e81\n```\n\n```\n# Handshake response sent by example.com\nHTTP/1.1 200\nX-Hook-Secret: b537207f20cbfa02357cf448134da559e8bd39d61597dcd5631b8012eae53e81\n```\n\n```\n# Response\nHTTP/1.1 201\n{\n  \"data\": {\n    \"gid\": \"43214\",\n    \"resource\": {\n      \"gid\": \"8675309\",\n      \"name\": \"Bugs\"\n    },\n    \"target\": \"https://example.com/receive-webhook/7654\",\n    \"active\": false,\n    \"last_success_at\": null,\n    \"last_failure_at\": null,\n    \"last_failure_content\": null\n  },\n  \"X-Hook-Secret\": \"b537207f20cbfa02357cf448134da559e8bd39d61597dcd5631b8012eae53e81\"\n}\n```",
        "operationId": "createWebhook",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "active",
              "created_at",
              "delivery_retry_count",
              "failure_deletion_timestamp",
              "filters",
              "filters.action",
              "filters.fields",
              "filters.resource_subtype",
              "last_failure_at",
              "last_failure_content",
              "last_success_at",
              "next_attempt_after",
              "resource",
              "resource.name",
              "target"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "active",
                  "created_at",
                  "delivery_retry_count",
                  "failure_deletion_timestamp",
                  "filters",
                  "filters.action",
                  "filters.fields",
                  "filters.resource_subtype",
                  "last_failure_at",
                  "last_failure_content",
                  "last_success_at",
                  "next_attempt_after",
                  "resource",
                  "resource.name",
                  "target"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/WebhookRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The webhook workspace and target.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "X-Hook-Secret": {
                          "description": "The secret to be used to verify future webhook event signatures.",
                          "example": "b537207f20cbfa02357cf448134da559e8bd39d61597dcd5631b8012eae53e81",
                          "type": "string"
                        },
                        "data": {
                          "$ref": "#/components/schemas/WebhookResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__WebhookResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created the requested webhook."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "webhooks:write"
            ]
          }
        ],
        "summary": "Establish a webhook",
        "tags": [
          "Webhooks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1webhooks/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nWebhook result = client.webhooks.createWebhook()\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet webhooksApiInstance = new Asana.WebhooksApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The webhook workspace and target.\nlet opts = { \n    'opt_fields': \"active,created_at,delivery_retry_count,failure_deletion_timestamp,filters,filters.action,filters.fields,filters.resource_subtype,last_failure_at,last_failure_content,last_success_at,next_attempt_after,resource,resource.name,target\"\n};\nwebhooksApiInstance.createWebhook(body, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.webhooks.createWebhook({field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nwebhooks_api_instance = asana.WebhooksApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The webhook workspace and target.\nopts = {\n    'opt_fields': \"active,created_at,delivery_retry_count,failure_deletion_timestamp,filters,filters.action,filters.fields,filters.resource_subtype,last_failure_at,last_failure_content,last_success_at,next_attempt_after,resource,resource.name,target\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Establish a webhook\n    api_response = webhooks_api_instance.create_webhook(body, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling WebhooksApi->create_webhook: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.webhooks.create_webhook({'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->webhooks->createWebhook(array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.webhooks.create_webhook(field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/webhooks/{webhook_gid}": {
      "delete": {
        "description": "<b>Required scope: </b><code>webhooks:delete</code>\n\nThis method *permanently* removes a webhook. Note that it may be possible to receive a request that was already in flight after deleting the webhook, but no further requests will be issued.",
        "operationId": "deleteWebhook",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested webhook."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "webhooks:delete"
            ]
          }
        ],
        "summary": "Delete a webhook",
        "tags": [
          "Webhooks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1webhooks~1{webhook_gid}/delete",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.webhooks.deleteWebhook(webhookGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet webhooksApiInstance = new Asana.WebhooksApi(client);\nlet webhook_gid = \"12345\"; // String | Globally unique identifier for the webhook.\n\nwebhooksApiInstance.deleteWebhook(webhook_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.webhooks.deleteWebhook(webhookGid)\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nwebhooks_api_instance = asana.WebhooksApi(api_client)\nwebhook_gid = \"12345\" # str | Globally unique identifier for the webhook.\n\n\ntry:\n    # Delete a webhook\n    api_response = webhooks_api_instance.delete_webhook(webhook_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling WebhooksApi->delete_webhook: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.webhooks.delete_webhook(webhook_gid, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->webhooks->deleteWebhook($webhook_gid, array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.webhooks.delete_webhook(webhook_gid: 'webhook_gid', options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "get": {
        "description": "<b>Required scope: </b><code>webhooks:read</code>\n\nReturns the full record for the given webhook.",
        "operationId": "getWebhook",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "active",
              "created_at",
              "delivery_retry_count",
              "failure_deletion_timestamp",
              "filters",
              "filters.action",
              "filters.fields",
              "filters.resource_subtype",
              "last_failure_at",
              "last_failure_content",
              "last_success_at",
              "next_attempt_after",
              "resource",
              "resource.name",
              "target"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "active",
                  "created_at",
                  "delivery_retry_count",
                  "failure_deletion_timestamp",
                  "filters",
                  "filters.action",
                  "filters.fields",
                  "filters.resource_subtype",
                  "last_failure_at",
                  "last_failure_content",
                  "last_success_at",
                  "next_attempt_after",
                  "resource",
                  "resource.name",
                  "target"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/WebhookResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__WebhookResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested webhook."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "webhooks:read"
            ]
          }
        ],
        "summary": "Get a webhook",
        "tags": [
          "Webhooks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1webhooks~1{webhook_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nWebhook result = client.webhooks.getWebhook(webhookGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet webhooksApiInstance = new Asana.WebhooksApi(client);\nlet webhook_gid = \"12345\"; // String | Globally unique identifier for the webhook.\nlet opts = { \n    'opt_fields': \"active,created_at,delivery_retry_count,failure_deletion_timestamp,filters,filters.action,filters.fields,filters.resource_subtype,last_failure_at,last_failure_content,last_success_at,next_attempt_after,resource,resource.name,target\"\n};\nwebhooksApiInstance.getWebhook(webhook_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.webhooks.getWebhook(webhookGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nwebhooks_api_instance = asana.WebhooksApi(api_client)\nwebhook_gid = \"12345\" # str | Globally unique identifier for the webhook.\nopts = {\n    'opt_fields': \"active,created_at,delivery_retry_count,failure_deletion_timestamp,filters,filters.action,filters.fields,filters.resource_subtype,last_failure_at,last_failure_content,last_success_at,next_attempt_after,resource,resource.name,target\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a webhook\n    api_response = webhooks_api_instance.get_webhook(webhook_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling WebhooksApi->get_webhook: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.webhooks.get_webhook(webhook_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->webhooks->getWebhook($webhook_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.webhooks.get_webhook(webhook_gid: 'webhook_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/webhook_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "put": {
        "description": "<b>Required scope: </b><code>webhooks:write</code>\n\nAn existing webhook's filters can be updated by making a PUT request on the URL for that webhook. Note that the webhook's previous `filters` array will be completely overwritten by the `filters` sent in the PUT request.",
        "operationId": "updateWebhook",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "active",
              "created_at",
              "delivery_retry_count",
              "failure_deletion_timestamp",
              "filters",
              "filters.action",
              "filters.fields",
              "filters.resource_subtype",
              "last_failure_at",
              "last_failure_content",
              "last_success_at",
              "next_attempt_after",
              "resource",
              "resource.name",
              "target"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "active",
                  "created_at",
                  "delivery_retry_count",
                  "failure_deletion_timestamp",
                  "filters",
                  "filters.action",
                  "filters.fields",
                  "filters.resource_subtype",
                  "last_failure_at",
                  "last_failure_content",
                  "last_success_at",
                  "next_attempt_after",
                  "resource",
                  "resource.name",
                  "target"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/WebhookUpdateRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The updated filters for the webhook.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/WebhookResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__WebhookResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully updated the webhook."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "webhooks:write"
            ]
          }
        ],
        "summary": "Update a webhook",
        "tags": [
          "Webhooks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1webhooks~1{webhook_gid}/put",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nWebhook result = client.webhooks.updateWebhook(webhookGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet webhooksApiInstance = new Asana.WebhooksApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The updated filters for the webhook.\nlet webhook_gid = \"12345\"; // String | Globally unique identifier for the webhook.\nlet opts = { \n    'opt_fields': \"active,created_at,delivery_retry_count,failure_deletion_timestamp,filters,filters.action,filters.fields,filters.resource_subtype,last_failure_at,last_failure_content,last_success_at,next_attempt_after,resource,resource.name,target\"\n};\nwebhooksApiInstance.updateWebhook(body, webhook_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.webhooks.updateWebhook(webhookGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nwebhooks_api_instance = asana.WebhooksApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The updated filters for the webhook.\nwebhook_gid = \"12345\" # str | Globally unique identifier for the webhook.\nopts = {\n    'opt_fields': \"active,created_at,delivery_retry_count,failure_deletion_timestamp,filters,filters.action,filters.fields,filters.resource_subtype,last_failure_at,last_failure_content,last_success_at,next_attempt_after,resource,resource.name,target\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Update a webhook\n    api_response = webhooks_api_instance.update_webhook(body, webhook_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling WebhooksApi->update_webhook: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.webhooks.update_webhook(webhook_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->webhooks->updateWebhook($webhook_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.webhooks.update_webhook(webhook_gid: 'webhook_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/workspace_memberships/{workspace_membership_gid}": {
      "get": {
        "description": "Returns the complete workspace record for a single workspace membership.",
        "operationId": "getWorkspaceMembership",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_at",
              "is_active",
              "is_admin",
              "is_guest",
              "is_view_only",
              "user",
              "user.name",
              "user_task_list",
              "user_task_list.name",
              "user_task_list.owner",
              "user_task_list.workspace",
              "vacation_dates",
              "vacation_dates.end_on",
              "vacation_dates.start_on",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_at",
                  "is_active",
                  "is_admin",
                  "is_guest",
                  "is_view_only",
                  "user",
                  "user.name",
                  "user_task_list",
                  "user_task_list.name",
                  "user_task_list.owner",
                  "user_task_list.workspace",
                  "vacation_dates",
                  "vacation_dates.end_on",
                  "vacation_dates.start_on",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/WorkspaceMembershipResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__WorkspaceMembershipResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested workspace membership."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get a workspace membership",
        "tags": [
          "Workspace memberships"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspace_memberships~1{workspace_membership_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.workspacememberships.getWorkspaceMembership(workspaceMembershipGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet workspaceMembershipsApiInstance = new Asana.WorkspaceMembershipsApi(client);\nlet workspace_membership_gid = \"12345\"; // String | \nlet opts = { \n    'opt_fields': \"created_at,is_active,is_admin,is_guest,is_view_only,user,user.name,user_task_list,user_task_list.name,user_task_list.owner,user_task_list.workspace,vacation_dates,vacation_dates.end_on,vacation_dates.start_on,workspace,workspace.name\"\n};\nworkspaceMembershipsApiInstance.getWorkspaceMembership(workspace_membership_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.workspacememberships.getWorkspaceMembership(workspaceMembershipGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nworkspace_memberships_api_instance = asana.WorkspaceMembershipsApi(api_client)\nworkspace_membership_gid = \"12345\" # str | \nopts = {\n    'opt_fields': \"created_at,is_active,is_admin,is_guest,is_view_only,user,user.name,user_task_list,user_task_list.name,user_task_list.owner,user_task_list.workspace,vacation_dates,vacation_dates.end_on,vacation_dates.start_on,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a workspace membership\n    api_response = workspace_memberships_api_instance.get_workspace_membership(workspace_membership_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling WorkspaceMembershipsApi->get_workspace_membership: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.workspace_memberships.get_workspace_membership(workspace_membership_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->workspacememberships->getWorkspaceMembership($workspace_membership_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.workspace_memberships.get_workspace_membership(workspace_membership_gid: 'workspace_membership_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/workspace_membership_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/workspaces": {
      "get": {
        "description": "<b>Required scope: </b><code>workspaces:read</code>\n\nReturns the compact records for all workspaces visible to the authorized user.",
        "operationId": "getWorkspaces",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "email_domains",
              "is_organization",
              "name",
              "offset",
              "path",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "email_domains",
                  "is_organization",
                  "name",
                  "offset",
                  "path",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/WorkspaceCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__WorkspaceResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Return all workspaces visible to the authorized user."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "workspaces:read"
            ]
          }
        ],
        "summary": "Get multiple workspaces",
        "tags": [
          "Workspaces"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Workspace> result = client.workspaces.getWorkspaces()\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet workspacesApiInstance = new Asana.WorkspacesApi(client);\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"email_domains,is_organization,name,offset,path,uri\"\n};\nworkspacesApiInstance.getWorkspaces(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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.workspaces.getWorkspaces({param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nworkspaces_api_instance = asana.WorkspacesApi(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    'opt_fields': \"email_domains,is_organization,name,offset,path,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get multiple workspaces\n    api_response = workspaces_api_instance.get_workspaces(opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling WorkspacesApi->get_workspaces: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.workspaces.get_workspaces({'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->workspaces->getWorkspaces(array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.workspaces.get_workspaces(param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/workspaces/{workspace_gid}": {
      "get": {
        "description": "<b>Required scope: </b><code>workspaces:read</code>\n\nReturns the full workspace record for a single workspace.",
        "operationId": "getWorkspace",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "email_domains",
              "is_organization",
              "name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "email_domains",
                  "is_organization",
                  "name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/WorkspaceResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__WorkspaceResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Return the full workspace record."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "workspaces:read"
            ]
          }
        ],
        "summary": "Get a workspace",
        "tags": [
          "Workspaces"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nWorkspace result = client.workspaces.getWorkspace(workspaceGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet workspacesApiInstance = new Asana.WorkspacesApi(client);\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\nlet opts = { \n    'opt_fields': \"email_domains,is_organization,name\"\n};\nworkspacesApiInstance.getWorkspace(workspace_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.workspaces.getWorkspace(workspaceGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nworkspaces_api_instance = asana.WorkspacesApi(api_client)\nworkspace_gid = \"12345\" # str | Globally unique identifier for the workspace or organization.\nopts = {\n    'opt_fields': \"email_domains,is_organization,name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a workspace\n    api_response = workspaces_api_instance.get_workspace(workspace_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling WorkspacesApi->get_workspace: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.workspaces.get_workspace(workspace_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->workspaces->getWorkspace($workspace_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.workspaces.get_workspace(workspace_gid: 'workspace_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/workspace_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "put": {
        "description": "A specific, existing workspace can be updated by making a PUT request on the URL for that workspace. Only the fields provided in the data block will be updated; any unspecified fields will remain unchanged.\nCurrently the only field that can be modified for a workspace is its name.\nReturns the complete, updated workspace record.",
        "operationId": "updateWorkspace",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "email_domains",
              "is_organization",
              "name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "email_domains",
                  "is_organization",
                  "name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/WorkspaceRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The workspace object with all updated properties.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/WorkspaceResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__WorkspaceResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Update for the workspace was successful."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Update a workspace",
        "tags": [
          "Workspaces"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}/put",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nWorkspace result = client.workspaces.updateWorkspace(workspaceGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet workspacesApiInstance = new Asana.WorkspacesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The workspace object with all updated properties.\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\nlet opts = { \n    'opt_fields': \"email_domains,is_organization,name\"\n};\nworkspacesApiInstance.updateWorkspace(body, workspace_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.workspaces.updateWorkspace(workspaceGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nworkspaces_api_instance = asana.WorkspacesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The workspace object with all updated properties.\nworkspace_gid = \"12345\" # str | Globally unique identifier for the workspace or organization.\nopts = {\n    'opt_fields': \"email_domains,is_organization,name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Update a workspace\n    api_response = workspaces_api_instance.update_workspace(body, workspace_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling WorkspacesApi->update_workspace: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.workspaces.update_workspace(workspace_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->workspaces->updateWorkspace($workspace_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.workspaces.update_workspace(workspace_gid: 'workspace_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/workspaces/{workspace_gid}/addUser": {
      "parameters": [
        {
          "$ref": "#/components/parameters/workspace_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "Add a user to a workspace or organization.\nThe user can be referenced by their globally unique user ID or their email address. Returns the full user record for the invited user.",
        "operationId": "addUserForWorkspace",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "email",
              "name",
              "photo",
              "photo.image_1024x1024",
              "photo.image_128x128",
              "photo.image_21x21",
              "photo.image_27x27",
              "photo.image_36x36",
              "photo.image_60x60"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "email",
                  "name",
                  "photo",
                  "photo.image_1024x1024",
                  "photo.image_128x128",
                  "photo.image_21x21",
                  "photo.image_27x27",
                  "photo.image_36x36",
                  "photo.image_60x60"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/WorkspaceAddUserRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The user to add to the workspace.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/UserBaseResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__UserBaseResponseData"
                    }
                  ]
                }
              }
            },
            "description": "The user was added successfully to the workspace or organization."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Add a user to a workspace or organization",
        "tags": [
          "Workspaces"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}~1addUser/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.workspaces.addUserForWorkspace(workspaceGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet workspacesApiInstance = new Asana.WorkspacesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The user to add to the workspace.\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\nlet opts = { \n    'opt_fields': \"email,name,photo,photo.image_1024x1024,photo.image_128x128,photo.image_21x21,photo.image_27x27,photo.image_36x36,photo.image_60x60\"\n};\nworkspacesApiInstance.addUserForWorkspace(body, workspace_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.workspaces.addUserForWorkspace(workspaceGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nworkspaces_api_instance = asana.WorkspacesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The user to add to the workspace.\nworkspace_gid = \"12345\" # str | Globally unique identifier for the workspace or organization.\nopts = {\n    'opt_fields': \"email,name,photo,photo.image_1024x1024,photo.image_128x128,photo.image_21x21,photo.image_27x27,photo.image_36x36,photo.image_60x60\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Add a user to a workspace or organization\n    api_response = workspaces_api_instance.add_user_for_workspace(body, workspace_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling WorkspacesApi->add_user_for_workspace: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.workspaces.add_user_for_workspace(workspace_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->workspaces->addUserForWorkspace($workspace_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.workspaces.add_user_for_workspace(workspace_gid: 'workspace_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/workspaces/{workspace_gid}/agents": {
      "get": {
        "description": "Returns the compact records of agents (AI Teammates) configured. Use `opt_fields` to request additional fields in the workspace.",
        "operationId": "getAgentsForWorkspace",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "behavior_guidance",
              "description",
              "name",
              "offset",
              "path",
              "photo",
              "photo.image_1024x1024",
              "photo.image_128x128",
              "photo.image_21x21",
              "photo.image_27x27",
              "photo.image_36x36",
              "photo.image_60x60",
              "resource_subtype",
              "uri",
              "workspace"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "behavior_guidance",
                  "description",
                  "name",
                  "offset",
                  "path",
                  "photo",
                  "photo.image_1024x1024",
                  "photo.image_128x128",
                  "photo.image_21x21",
                  "photo.image_27x27",
                  "photo.image_36x36",
                  "photo.image_60x60",
                  "resource_subtype",
                  "uri",
                  "workspace"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/AgentCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__AgentResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested workspace's agents."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get a list of agents in a workspace",
        "tags": [
          "Agents"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}~1agents/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet agentsApiInstance = new Asana.AgentsApi(client);\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"behavior_guidance,description,name,offset,path,photo,photo.image_1024x1024,photo.image_128x128,photo.image_21x21,photo.image_27x27,photo.image_36x36,photo.image_60x60,resource_subtype,uri,workspace\"\n};\nagentsApiInstance.getAgentsForWorkspace(workspace_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nagents_api_instance = asana.AgentsApi(api_client)\nworkspace_gid = \"12345\" # str | Globally unique identifier for the workspace or organization.\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    'opt_fields': \"behavior_guidance,description,name,offset,path,photo,photo.image_1024x1024,photo.image_128x128,photo.image_21x21,photo.image_27x27,photo.image_36x36,photo.image_60x60,resource_subtype,uri,workspace\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a list of agents in a workspace\n    api_response = agents_api_instance.get_agents_for_workspace(workspace_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling AgentsApi->get_agents_for_workspace: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/workspace_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/workspaces/{workspace_gid}/ai_studio/runs": {
      "get": {
        "description": "Returns one row per AI Studio run (rule execution) for the workspace, in ascending order (oldest first) so that incremental consumers can poll forward. Each row describes what ran, who it is attributed to, the model used, and the credits consumed.\n\nCredit data is available from January 8th, 2025 onward, and is queryable for the full history since then (there is no limit on how far back you can query). A `start_at` earlier than January 8th, 2025 is silently clamped; it is not an error.\n\nThe list is always [paginated](/docs/pagination). When more results exist, the response includes a `next_page` with an `offset` that can be used to retrieve the next set of rows. The row `gid` is stable and can be used to de-duplicate rows across incremental loads.\n\nThis endpoint is restricted to [service accounts](https://help.asana.com/s/article/service-accounts) in organizations licensed for AI Studio.",
        "operationId": "getAiStudioRuns",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/AiStudioRunResponse"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__AiStudioRunResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved AI Studio credit utilization rows."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get AI Studio credit utilization",
        "tags": [
          "AI Studio usage API"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}~1ai_studio~1runs/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet aiStudioUsageApiApiInstance = new Asana.AIStudioUsageAPIApi(client);\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\nlet opts = { \n    'start_at': \"2013-10-20T19:20:30+01:00\", \n    'end_at': \"2013-10-20T19:20:30+01:00\", \n    'division_gid': \"division_gid_example\", \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\"\n};\naiStudioUsageApiApiInstance.getAiStudioRuns(workspace_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nai_studio_usage_api_api_instance = asana.AIStudioUsageAPIApi(api_client)\nworkspace_gid = \"12345\" # str | Globally unique identifier for the workspace or organization.\nopts = {\n    'start_at': '2013-10-20T19:20:30+01:00', # datetime | Inclusive lower bound. Runs are ordered and filtered by when their usage was recorded (the monotonic timestamp used for incremental polling), not by `run_started_at`. Omitted ⇒ the 2025-01-08 floor — no credit data exists before then, and there is no limit on how far back you can query. A value earlier than 2025-01-08 is treated as 2025-01-08 (not rejected), matching the audit log.\n    'end_at': '2013-10-20T19:20:30+01:00', # datetime | Filter to runs whose usage was recorded before this time (exclusive) — by when the run's credit usage was recorded, not by `run_started_at`. Defaults to the time of the request.\n    'division_gid': \"division_gid_example\", # str | Scope results to a single division (its gid). Omitted ⇒ the org's first licensed division. Use this to retrieve only one division's slice (e.g. for a division-level admin or billing owner) rather than the whole organization.\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}\n\ntry:\n    # Get AI Studio credit utilization\n    api_response = ai_studio_usage_api_api_instance.get_ai_studio_runs(workspace_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling AIStudioUsageAPIApi->get_ai_studio_runs: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/workspace_path_gid"
        },
        {
          "$ref": "#/components/parameters/ai_studio_start_at"
        },
        {
          "$ref": "#/components/parameters/ai_studio_end_at"
        },
        {
          "$ref": "#/components/parameters/ai_studio_division_gid"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/workspaces/{workspace_gid}/ai_studio/seats": {
      "get": {
        "description": "Returns a current snapshot of AI Studio seat allocations for the workspace — who has access, at what license tier, and the state of each seat. This is a point-in-time snapshot; customers build their own history tables on top of periodic pulls.\n\nThe list is always [paginated](/docs/pagination). When more results exist, the response includes a `next_page` with an `offset` that can be used to retrieve the next set of rows.\n\nThis endpoint is restricted to [service accounts](https://help.asana.com/s/article/service-accounts) in organizations licensed for AI Studio.",
        "operationId": "getAiStudioSeats",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/AiStudioSeatResponse"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__AiStudioSeatResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved AI Studio seats."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get AI Studio seats",
        "tags": [
          "AI Studio usage API"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}~1ai_studio~1seats/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet aiStudioUsageApiApiInstance = new Asana.AIStudioUsageAPIApi(client);\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\nlet opts = { \n    'state': \"state_example\", \n    'division_gid': \"division_gid_example\", \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\"\n};\naiStudioUsageApiApiInstance.getAiStudioSeats(workspace_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nai_studio_usage_api_api_instance = asana.AIStudioUsageAPIApi(api_client)\nworkspace_gid = \"12345\" # str | Globally unique identifier for the workspace or organization.\nopts = {\n    'state': \"state_example\", # str | Filter seats to this state.\n    'division_gid': \"division_gid_example\", # str | Scope results to a single division (its gid). Omitted ⇒ the org's first licensed division. Use this to retrieve only one division's slice (e.g. for a division-level admin or billing owner) rather than the whole organization.\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}\n\ntry:\n    # Get AI Studio seats\n    api_response = ai_studio_usage_api_api_instance.get_ai_studio_seats(workspace_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling AIStudioUsageAPIApi->get_ai_studio_seats: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/workspace_path_gid"
        },
        {
          "$ref": "#/components/parameters/ai_studio_seat_state"
        },
        {
          "$ref": "#/components/parameters/ai_studio_division_gid"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/workspaces/{workspace_gid}/audit_log_events": {
      "get": {
        "description": "Retrieve the audit log events that have been captured in your domain.\n\nThis endpoint will return a list of [AuditLogEvent](/reference/audit-log-api) objects, sorted by creation time in ascending order. Note that the Audit Log API captures events from October 8th, 2021 and later. Queries for events before this date will not return results.\n\nThere are a number of query parameters (below) that can be used to filter the set of [AuditLogEvent](/reference/audit-log-api) objects that are returned in the response. Any combination of query parameters is valid. When no filters are provided, all of the events that have been captured in your domain will match.\n\nThe list of events will always be [paginated](/docs/pagination). The default limit is 1000 events. The next set of events can be retrieved using the `offset` from the previous response. If there are no events that match the provided filters in your domain, the endpoint will return `null` for the `next_page` field. Querying again with the same filters may return new events if they were captured after the last request. Once a response includes a `next_page` with an `offset`, subsequent requests can be made with the latest `offset` to poll for new events that match the provided filters.\n\n*Note: If the filters you provided match events in your domain and `next_page` is present in the response, we will continue to send `next_page` on subsequent requests even when there are no more events that match the filters. This was put in place so that you can implement an audit log stream that will return future events that match these filters. If you are not interested in future events that match the filters you have defined, you can rely on checking empty `data` response for the end of current events that match your filters.*\n\nWhen no `offset` is provided, the response will begin with the oldest events that match the provided filters. It is important to note that [AuditLogEvent](/reference/audit-log-api) objects will be permanently deleted from our systems after 90 days. If you wish to keep a permanent record of these events, we recommend using a SIEM tool to ingest and store these logs.",
        "operationId": "getAuditLogEvents",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/AuditLogEvent"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__AuditLogEventArray"
                    }
                  ]
                }
              }
            },
            "description": "AuditLogEvents were successfully retrieved."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get audit log events",
        "tags": [
          "Audit log API"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}~1audit_log_events/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<JsonElement> result = client.auditlogapi.getAuditLogEvents(workspaceGid, resourceGid, actorGid, actorType, eventType, endAt, startAt)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet auditLogApiApiInstance = new Asana.AuditLogAPIApi(client);\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\nlet opts = { \n    'start_at': \"2013-10-20T19:20:30+01:00\", \n    'end_at': \"2013-10-20T19:20:30+01:00\", \n    'event_type': \"event_type_example\", \n    'actor_type': \"actor_type_example\", \n    'actor_gid': \"actor_gid_example\", \n    'resource_gid': \"resource_gid_example\", \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\"\n};\nauditLogApiApiInstance.getAuditLogEvents(workspace_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.auditlogapi.getAuditLogEvents(workspaceGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\naudit_log_api_api_instance = asana.AuditLogAPIApi(api_client)\nworkspace_gid = \"12345\" # str | Globally unique identifier for the workspace or organization.\nopts = {\n    'start_at': '2013-10-20T19:20:30+01:00', # datetime | Filter to events created after this time (inclusive).\n    'end_at': '2013-10-20T19:20:30+01:00', # datetime | Filter to events created before this time (exclusive).\n    'event_type': \"event_type_example\", # str | Filter to events of this type. Refer to the [supported audit log events](/docs/audit-log-events#supported-audit-log-events) for a full list of values.\n    'actor_type': \"actor_type_example\", # str | Filter to events with an actor of this type. This only needs to be included if querying for actor types without an ID. If `actor_gid` is included, this should be excluded.\n    'actor_gid': \"actor_gid_example\", # str | Filter to events triggered by the actor with this ID.\n    'resource_gid': \"resource_gid_example\", # str | Filter to events with this resource ID.\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}\n\ntry:\n    # Get audit log events\n    api_response = audit_log_api_api_instance.get_audit_log_events(workspace_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling AuditLogAPIApi->get_audit_log_events: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.audit_log_api.get_audit_log_events(workspace_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->auditlogapi->getAuditLogEvents($workspace_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.audit_log_api.get_audit_log_events(workspace_gid: 'workspace_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/workspace_path_gid"
        },
        {
          "$ref": "#/components/parameters/audit_log_start_at"
        },
        {
          "$ref": "#/components/parameters/audit_log_end_at"
        },
        {
          "$ref": "#/components/parameters/audit_log_event_type"
        },
        {
          "$ref": "#/components/parameters/audit_log_actor_type"
        },
        {
          "$ref": "#/components/parameters/audit_log_actor_gid"
        },
        {
          "$ref": "#/components/parameters/audit_log_resource_gid"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/workspaces/{workspace_gid}/custom_fields": {
      "get": {
        "description": "<b>Required scope: </b><code>custom_fields:read</code>\n\nReturns a list of the compact representation of all of the custom fields in a workspace.",
        "operationId": "getCustomFieldsForWorkspace",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "asana_created_field",
              "created_by",
              "created_by.name",
              "currency_code",
              "custom_label",
              "custom_label_position",
              "date_value",
              "date_value.date",
              "date_value.date_time",
              "default_access_level",
              "description",
              "display_value",
              "enabled",
              "enum_options",
              "enum_options.color",
              "enum_options.enabled",
              "enum_options.name",
              "enum_value",
              "enum_value.color",
              "enum_value.enabled",
              "enum_value.name",
              "format",
              "has_notifications_enabled",
              "html_text_value",
              "id_prefix",
              "input_restrictions",
              "is_formula_field",
              "is_global_to_workspace",
              "is_lookup_field",
              "is_value_read_only",
              "multi_enum_values",
              "multi_enum_values.color",
              "multi_enum_values.enabled",
              "multi_enum_values.name",
              "name",
              "number_value",
              "offset",
              "path",
              "people_value",
              "people_value.name",
              "precision",
              "privacy_setting",
              "reference_value",
              "reference_value.name",
              "representation_type",
              "resource_subtype",
              "text_value",
              "type",
              "uri"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "asana_created_field",
                  "created_by",
                  "created_by.name",
                  "currency_code",
                  "custom_label",
                  "custom_label_position",
                  "date_value",
                  "date_value.date",
                  "date_value.date_time",
                  "default_access_level",
                  "description",
                  "display_value",
                  "enabled",
                  "enum_options",
                  "enum_options.color",
                  "enum_options.enabled",
                  "enum_options.name",
                  "enum_value",
                  "enum_value.color",
                  "enum_value.enabled",
                  "enum_value.name",
                  "format",
                  "has_notifications_enabled",
                  "html_text_value",
                  "id_prefix",
                  "input_restrictions",
                  "is_formula_field",
                  "is_global_to_workspace",
                  "is_lookup_field",
                  "is_value_read_only",
                  "multi_enum_values",
                  "multi_enum_values.color",
                  "multi_enum_values.enabled",
                  "multi_enum_values.name",
                  "name",
                  "number_value",
                  "offset",
                  "path",
                  "people_value",
                  "people_value.name",
                  "precision",
                  "privacy_setting",
                  "reference_value",
                  "reference_value.name",
                  "representation_type",
                  "resource_subtype",
                  "text_value",
                  "type",
                  "uri"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/CustomFieldResponse"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__CustomFieldResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved all custom fields for the given workspace."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "custom_fields:read"
            ]
          }
        ],
        "summary": "Get a workspace's custom fields",
        "tags": [
          "Custom fields"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}~1custom_fields/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<CustomField> result = client.customfields.getCustomFieldsForWorkspace(workspaceGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet customFieldsApiInstance = new Asana.CustomFieldsApi(client);\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"asana_created_field,created_by,created_by.name,currency_code,custom_label,custom_label_position,date_value,date_value.date,date_value.date_time,default_access_level,description,display_value,enabled,enum_options,enum_options.color,enum_options.enabled,enum_options.name,enum_value,enum_value.color,enum_value.enabled,enum_value.name,format,has_notifications_enabled,html_text_value,id_prefix,input_restrictions,is_formula_field,is_global_to_workspace,is_lookup_field,is_value_read_only,multi_enum_values,multi_enum_values.color,multi_enum_values.enabled,multi_enum_values.name,name,number_value,offset,path,people_value,people_value.name,precision,privacy_setting,reference_value,reference_value.name,representation_type,resource_subtype,text_value,type,uri\"\n};\ncustomFieldsApiInstance.getCustomFieldsForWorkspace(workspace_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.customfields.getCustomFieldsForWorkspace(workspaceGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ncustom_fields_api_instance = asana.CustomFieldsApi(api_client)\nworkspace_gid = \"12345\" # str | Globally unique identifier for the workspace or organization.\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    'opt_fields': \"asana_created_field,created_by,created_by.name,currency_code,custom_label,custom_label_position,date_value,date_value.date,date_value.date_time,default_access_level,description,display_value,enabled,enum_options,enum_options.color,enum_options.enabled,enum_options.name,enum_value,enum_value.color,enum_value.enabled,enum_value.name,format,has_notifications_enabled,html_text_value,id_prefix,input_restrictions,is_formula_field,is_global_to_workspace,is_lookup_field,is_value_read_only,multi_enum_values,multi_enum_values.color,multi_enum_values.enabled,multi_enum_values.name,name,number_value,offset,path,people_value,people_value.name,precision,privacy_setting,reference_value,reference_value.name,representation_type,resource_subtype,text_value,type,uri\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a workspace's custom fields\n    api_response = custom_fields_api_instance.get_custom_fields_for_workspace(workspace_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling CustomFieldsApi->get_custom_fields_for_workspace: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.custom_fields.get_custom_fields_for_workspace(workspace_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->customfields->getCustomFieldsForWorkspace($workspace_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.custom_fields.get_custom_fields_for_workspace(workspace_gid: 'workspace_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/workspace_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/workspaces/{workspace_gid}/events": {
      "get": {
        "description": "Returns the full record for all events that have occurred since the sync token was created.\nThe response is a list of events and the schema of each event is as described [here](/reference/events).\nAsana limits a single sync token to 1000 events. If more than 1000 events exist for a given domain, `has_more: true` will be returned in the response, indicating that there are more events to pull.",
        "operationId": "getWorkspaceEvents",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "description": "The full record for all events that have occurred since the sync token was created.",
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/EventResponse"
                          },
                          "type": "array"
                        },
                        "has_more": {
                          "description": "Indicates whether there are more events to pull.",
                          "example": true,
                          "type": "boolean"
                        },
                        "sync": {
                          "description": "A sync token to be used with the next call to the /events endpoint.",
                          "example": "de4774f6915eae04714ca93bb2f5ee81",
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EventResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved events."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get workspace events",
        "tags": [
          "Workspaces"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}~1events/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet workspacesApiInstance = new Asana.WorkspacesApi(client);\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\nlet opts = { \n    'sync': \"de4774f6915eae04714ca93bb2f5ee81\"\n};\nworkspacesApiInstance.getWorkspaceEvents(workspace_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nworkspaces_api_instance = asana.WorkspacesApi(api_client)\nworkspace_gid = \"12345\" # str | Globally unique identifier for the workspace or organization.\nopts = {\n    'sync': \"de4774f6915eae04714ca93bb2f5ee81\", # str | A sync token received from the last request, or none on first sync. Events will be returned from the point in time that the sync token was generated. *Note: On your first request, omit the sync token. The response will be the same as for an expired sync token, and will include a new valid sync token. If the sync token is too old (which may happen from time to time) the API will return a `412 Precondition Failed` error, and include a fresh sync token in the response.*\n}\n\ntry:\n    # Get workspace events\n    api_response = workspaces_api_instance.get_workspace_events(workspace_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling WorkspacesApi->get_workspace_events: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/workspace_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "description": "A sync token received from the last request, or none on first sync. Events will be returned from the point in time that the sync token was generated.\n*Note: On your first request, omit the sync token. The response will be the same as for an expired sync token, and will include a new valid sync token. If the sync token is too old (which may happen from time to time) the API will return a `412 Precondition Failed` error, and include a fresh sync token in the response.*",
          "example": "de4774f6915eae04714ca93bb2f5ee81",
          "in": "query",
          "name": "sync",
          "required": false,
          "schema": {
            "type": "string"
          }
        }
      ]
    },
    "/workspaces/{workspace_gid}/projects": {
      "get": {
        "description": "<b>Required scope: </b><code>projects:read</code>\n\nReturns the compact project records for all projects in the workspace.\n*Note: This endpoint may timeout for large domains. To fetch projects shared with a specific team, use `GET /memberships` with `member` set to the team GID and `resource_subtype` set to `project_membership`.*",
        "operationId": "getProjectsForWorkspace",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "$ref": "#/components/parameters/archived_query_param"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "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.default_access_level",
              "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.html_text_value",
              "custom_field_settings.custom_field.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_global_to_workspace",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.privacy_setting",
              "custom_field_settings.custom_field.reference_value",
              "custom_field_settings.custom_field.reference_value.name",
              "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.parent.resource_subtype",
              "custom_field_settings.project",
              "custom_field_settings.project.name",
              "custom_field_settings.project.resource_subtype",
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "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",
              "resource_subtype",
              "start_on",
              "team",
              "team.name",
              "uri",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "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.default_access_level",
                  "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.html_text_value",
                  "custom_field_settings.custom_field.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_global_to_workspace",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.privacy_setting",
                  "custom_field_settings.custom_field.reference_value",
                  "custom_field_settings.custom_field.reference_value.name",
                  "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.parent.resource_subtype",
                  "custom_field_settings.project",
                  "custom_field_settings.project.name",
                  "custom_field_settings.project.resource_subtype",
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "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",
                  "resource_subtype",
                  "start_on",
                  "team",
                  "team.name",
                  "uri",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/ProjectCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ProjectResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested workspace's projects."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "projects:read"
            ]
          }
        ],
        "summary": "Get all projects in a workspace",
        "tags": [
          "Projects"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}~1projects/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Project> result = client.projects.getProjectsForWorkspace(workspaceGid, archived)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectsApiInstance = new Asana.ProjectsApi(client);\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,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,resource_subtype,start_on,team,team.name,uri,workspace,workspace.name\"\n};\nprojectsApiInstance.getProjectsForWorkspace(workspace_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projects.getProjectsForWorkspace(workspaceGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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)\nworkspace_gid = \"12345\" # str | Globally unique identifier for the workspace or organization.\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    '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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,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,resource_subtype,start_on,team,team.name,uri,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get all projects in a workspace\n    api_response = projects_api_instance.get_projects_for_workspace(workspace_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectsApi->get_projects_for_workspace: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.projects.get_projects_for_workspace(workspace_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->projects->getProjectsForWorkspace($workspace_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "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_for_workspace(workspace_gid: 'workspace_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/workspace_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/workspaces/{workspace_gid}/projects/search": {
      "get": {
        "description": "<b>Required scope: </b><code>projects:read</code>\n\nTo mirror the functionality of the Asana web app's advanced search feature, the Asana API has a project search endpoint that allows you to build complex filters to find and retrieve the exact data you need.\n#### Premium access\nLike the Asana web product's advance search feature, this search endpoint will only be available to premium Asana users. A user is premium if any of the following is true:\n\n- The workspace in which the search is being performed is a premium workspace\n- The user is a member of a premium team inside the workspace\n\nEven if a user is only a member of a premium team inside a non-premium workspace, search will allow them to find data anywhere in the workspace, not just inside the premium team. Making a search request using credentials of a non-premium user will result in a `402 Payment Required` error.\n#### Pagination\nSearch results are not stable; repeating the same query multiple times may return the data in a different order, even if the data do not change. Because of this, the traditional [pagination](/docs/pagination) available elsewhere in the Asana API is not available here. However, you can paginate manually by sorting the search results by their creation time and then modifying each subsequent query to exclude data you have already seen. Page sizes are limited to a maximum of 100 items, and can be specified by the `limit` query parameter.\n#### Eventual consistency\nChanges in Asana (regardless of whether they’re made though the web product or the API) are forwarded to our search infrastructure to be indexed. This process can take between 10 and 60 seconds to complete under normal operation, and longer during some production incidents. Making a change to a project that would alter its presence in a particular search query will not be reflected immediately. This is also true of the advanced search feature in the web product.\nBecause of this delay, the search endpoint is not suited for use cases that require immediate consistency after writes. If you need read-your-write behavior or strongly consistent results, we recommend using [Get multiple projects](/reference/getprojects) instead.\n#### Rate limits\nYou may receive a `429 Too Many Requests` response if you hit any of our [rate limits](/docs/rate-limits).\n#### Custom field parameters\n| Parameter name | Custom field type | Accepted type |\n|---|---|---|\n| custom_fields.{gid}.is_set | All | Boolean |\n| custom_fields.{gid}.value | Text | String |\n| custom_fields.{gid}.value | Number | Number |\n| custom_fields.{gid}.value | Enum | Enum option ID |\n| custom_fields.{gid}.starts_with | Text only | String |\n| custom_fields.{gid}.ends_with | Text only | String |\n| custom_fields.{gid}.contains | Text only | String |\n| custom_fields.{gid}.less_than | Number only | Number |\n| custom_fields.{gid}.greater_than | Number only | Number |\n\n\nFor example, if the gid of the custom field is 12345, the query parameter to find projects where it is set would be `custom_fields.12345.is_set=true`. To match an exact value for an enum custom field, use the gid of the desired enum option and not the name of the enum option: `custom_fields.12345.value=67890`.\n\n**Not Supported**: searching for multiple exact matches of a custom field, searching for multi-enum custom field",
        "operationId": "searchProjectsForWorkspace",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "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.default_access_level",
              "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.html_text_value",
              "custom_field_settings.custom_field.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_global_to_workspace",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.privacy_setting",
              "custom_field_settings.custom_field.reference_value",
              "custom_field_settings.custom_field.reference_value.name",
              "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.parent.resource_subtype",
              "custom_field_settings.project",
              "custom_field_settings.project.name",
              "custom_field_settings.project.resource_subtype",
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "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",
              "resource_subtype",
              "start_on",
              "team",
              "team.name",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "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.default_access_level",
                  "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.html_text_value",
                  "custom_field_settings.custom_field.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_global_to_workspace",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.privacy_setting",
                  "custom_field_settings.custom_field.reference_value",
                  "custom_field_settings.custom_field.reference_value.name",
                  "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.parent.resource_subtype",
                  "custom_field_settings.project",
                  "custom_field_settings.project.name",
                  "custom_field_settings.project.resource_subtype",
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "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",
                  "resource_subtype",
                  "start_on",
                  "team",
                  "team.name",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/ProjectCompact"
                          },
                          "type": "array"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__ProjectResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved matching projects."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "projects:read"
            ]
          }
        ],
        "summary": "Search projects in a workspace",
        "tags": [
          "Projects"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}~1projects~1search/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectsApiInstance = new Asana.ProjectsApi(client);\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\nlet opts = { \n    'limit': 50, \n    'text': \"Bugs\", \n    'sort_by': \"modified_at\", \n    'sort_ascending': false, \n    'completed': false, \n    'teams.any': \"12345,67890\", \n    'owner.any': \"12345,67890\", \n    'members.any': \"12345,67890\", \n    'members.not': \"12345,67890\", \n    'portfolios.any': \"12345,67890\", \n    'completed_on': \"2019-09-15\", \n    'completed_on.before': \"2019-09-15\", \n    'completed_on.after': \"2019-09-15\", \n    'completed_at.before': \"2019-04-15T01:01:46.055Z\", \n    'completed_at.after': \"2019-04-15T01:01:46.055Z\", \n    'created_on': \"2019-09-15\", \n    'created_on.before': \"2019-09-15\", \n    'created_on.after': \"2019-09-15\", \n    'created_at.before': \"2019-04-15T01:01:46.055Z\", \n    'created_at.after': \"2019-04-15T01:01:46.055Z\", \n    'due_on': \"2019-09-15\", \n    'due_on.before': \"2019-09-15\", \n    'due_on.after': \"2019-09-15\", \n    'due_at.before': \"2019-04-15T01:01:46.055Z\", \n    'due_at.after': \"2019-04-15T01:01:46.055Z\", \n    'start_on': \"2019-09-15\", \n    'start_on.before': \"2019-09-15\", \n    'start_on.after': \"2019-09-15\", \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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,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,resource_subtype,start_on,team,team.name,workspace,workspace.name\"\n};\nprojectsApiInstance.searchProjectsForWorkspace(workspace_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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)\nworkspace_gid = \"12345\" # str | Globally unique identifier for the workspace or organization.\nopts = {\n    'limit': 50, # int | Results per search response. The number of objects to return in one search response. The value must be between 1 and 100. Search responses have no `next_page`, so to retrieve further results, sort by `created_at` and repeat the query with a `created_at.before` or `created_at.after` filter that excludes the results you have already seen.\n    'text': \"Bugs\", # str | Performs full-text search on the project name.\n    'sort_by': \"modified_at\", # str | One of `due_date`, `created_at`, `completed_at`, `relevance`, or `modified_at`, defaults to `modified_at`.\n    'sort_ascending': False, # bool | Default `false`.\n    'completed': False, # bool | Filter on project completion status.\n    'teams.any': \"12345,67890\", # str | Comma-separated list of team IDs.\n    'owner.any': \"12345,67890\", # str | Comma-separated list of user identifiers to filter on as project owners. This can either be the string \\\"me\\\", an email, or the gid of a user.\n    'members.any': \"12345,67890\", # str | Comma-separated list of user identifiers to filter on as members. This can either be the string \\\"me\\\", an email, or the gid of a user.\n    'members.not': \"12345,67890\", # str | Comma-separated list of user identifiers to exclude as members. This can either be the string \\\"me\\\", an email, or the gid of a user.\n    'portfolios.any': \"12345,67890\", # str | Comma-separated list of portfolio IDs to filter on.\n    'completed_on': '2019-09-15', # date | ISO 8601 date string or `null`.\n    'completed_on.before': '2019-09-15', # date | ISO 8601 date string.\n    'completed_on.after': '2019-09-15', # date | ISO 8601 date string.\n    'completed_at.before': '2019-04-15T01:01:46.055Z', # datetime | ISO 8601 datetime string.\n    'completed_at.after': '2019-04-15T01:01:46.055Z', # datetime | ISO 8601 datetime string.\n    'created_on': '2019-09-15', # date | ISO 8601 date string or `null`.\n    'created_on.before': '2019-09-15', # date | ISO 8601 date string.\n    'created_on.after': '2019-09-15', # date | ISO 8601 date string.\n    'created_at.before': '2019-04-15T01:01:46.055Z', # datetime | ISO 8601 datetime string.\n    'created_at.after': '2019-04-15T01:01:46.055Z', # datetime | ISO 8601 datetime string.\n    'due_on': '2019-09-15', # date | ISO 8601 date string or `null`.\n    'due_on.before': '2019-09-15', # date | ISO 8601 date string.\n    'due_on.after': '2019-09-15', # date | ISO 8601 date string.\n    'due_at.before': '2019-04-15T01:01:46.055Z', # datetime | ISO 8601 datetime string.\n    'due_at.after': '2019-04-15T01:01:46.055Z', # datetime | ISO 8601 datetime string.\n    'start_on': '2019-09-15', # date | ISO 8601 date string or `null`.\n    'start_on.before': '2019-09-15', # date | ISO 8601 date string.\n    'start_on.after': '2019-09-15', # date | ISO 8601 date string.\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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,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,resource_subtype,start_on,team,team.name,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Search projects in a workspace\n    api_response = projects_api_instance.search_projects_for_workspace(workspace_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectsApi->search_projects_for_workspace: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/workspace_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/search_limit"
        },
        {
          "description": "Performs full-text search on the project name.",
          "example": "Bugs",
          "in": "query",
          "name": "text",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "One of `due_date`, `created_at`, `completed_at`, `relevance`, or `modified_at`, defaults to `modified_at`.",
          "example": "modified_at",
          "in": "query",
          "name": "sort_by",
          "schema": {
            "default": "modified_at",
            "enum": [
              "due_date",
              "created_at",
              "completed_at",
              "modified_at",
              "relevance"
            ],
            "type": "string"
          }
        },
        {
          "description": "Default `false`.",
          "example": false,
          "in": "query",
          "name": "sort_ascending",
          "schema": {
            "default": false,
            "type": "boolean"
          }
        },
        {
          "description": "Filter on project completion status.",
          "example": false,
          "in": "query",
          "name": "completed",
          "schema": {
            "type": "boolean"
          }
        },
        {
          "description": "Comma-separated list of team IDs.",
          "example": "12345,67890",
          "in": "query",
          "name": "teams.any",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of user identifiers to filter on as project owners. This can either be the string \"me\", an email, or the gid of a user.",
          "example": "12345,67890",
          "in": "query",
          "name": "owner.any",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of user identifiers to filter on as members. This can either be the string \"me\", an email, or the gid of a user.",
          "example": "12345,67890",
          "in": "query",
          "name": "members.any",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of user identifiers to exclude as members. This can either be the string \"me\", an email, or the gid of a user.",
          "example": "12345,67890",
          "in": "query",
          "name": "members.not",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of portfolio IDs to filter on.",
          "example": "12345,67890",
          "in": "query",
          "name": "portfolios.any",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string or `null`.",
          "example": "2019-09-15",
          "in": "query",
          "name": "completed_on",
          "schema": {
            "format": "date",
            "nullable": true,
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string.",
          "example": "2019-09-15",
          "in": "query",
          "name": "completed_on.before",
          "schema": {
            "format": "date",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string.",
          "example": "2019-09-15",
          "in": "query",
          "name": "completed_on.after",
          "schema": {
            "format": "date",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 datetime string.",
          "example": "2019-04-15T01:01:46.055Z",
          "in": "query",
          "name": "completed_at.before",
          "schema": {
            "format": "date-time",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 datetime string.",
          "example": "2019-04-15T01:01:46.055Z",
          "in": "query",
          "name": "completed_at.after",
          "schema": {
            "format": "date-time",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string or `null`.",
          "example": "2019-09-15",
          "in": "query",
          "name": "created_on",
          "schema": {
            "format": "date",
            "nullable": true,
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string.",
          "example": "2019-09-15",
          "in": "query",
          "name": "created_on.before",
          "schema": {
            "format": "date",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string.",
          "example": "2019-09-15",
          "in": "query",
          "name": "created_on.after",
          "schema": {
            "format": "date",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 datetime string.",
          "example": "2019-04-15T01:01:46.055Z",
          "in": "query",
          "name": "created_at.before",
          "schema": {
            "format": "date-time",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 datetime string.",
          "example": "2019-04-15T01:01:46.055Z",
          "in": "query",
          "name": "created_at.after",
          "schema": {
            "format": "date-time",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string or `null`.",
          "example": "2019-09-15",
          "in": "query",
          "name": "due_on",
          "schema": {
            "format": "date",
            "nullable": true,
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string.",
          "example": "2019-09-15",
          "in": "query",
          "name": "due_on.before",
          "schema": {
            "format": "date",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string.",
          "example": "2019-09-15",
          "in": "query",
          "name": "due_on.after",
          "schema": {
            "format": "date",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 datetime string.",
          "example": "2019-04-15T01:01:46.055Z",
          "in": "query",
          "name": "due_at.before",
          "schema": {
            "format": "date-time",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 datetime string.",
          "example": "2019-04-15T01:01:46.055Z",
          "in": "query",
          "name": "due_at.after",
          "schema": {
            "format": "date-time",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string or `null`.",
          "example": "2019-09-15",
          "in": "query",
          "name": "start_on",
          "schema": {
            "format": "date",
            "nullable": true,
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string.",
          "example": "2019-09-15",
          "in": "query",
          "name": "start_on.before",
          "schema": {
            "format": "date",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string.",
          "example": "2019-09-15",
          "in": "query",
          "name": "start_on.after",
          "schema": {
            "format": "date",
            "type": "string"
          }
        }
      ]
    },
    "/workspaces/{workspace_gid}/records/search": {
      "get": {
        "description": "<b>Required scope: </b><code>records:read</code>\n\nTo mirror the functionality of the Asana web app's advanced search feature, this endpoint allows you to build complex filters to find and retrieve records across all of a workspace's tables.\nCustom field filters are also supported, using the same `custom_fields.{gid}.*` query parameters documented for [task search](/reference/searchtasksforworkspace).\n#### Premium access\nLike task search, this endpoint is only available to premium Asana users. Making a search request using credentials of a non-premium user will result in a `402 Payment Required` error.\n#### Pagination\nSearch results are not stable; repeating the same query multiple times may return the data in a different order, even if the data do not change. Page sizes are limited to a maximum of 100 items, and can be specified by the `limit` query parameter.\n#### Eventual consistency\nChanges in Asana are forwarded to our search infrastructure to be indexed, which can take between 10 and 60 seconds to complete under normal operation. If you need read-your-write behavior, use [Get records in a table](/reference/getrecordsfortable) instead.",
        "operationId": "searchRecordsForWorkspace",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "comment_count",
              "created_at",
              "created_by",
              "created_by.name",
              "custom_fields",
              "custom_fields.asana_created_field",
              "custom_fields.created_by",
              "custom_fields.created_by.name",
              "custom_fields.currency_code",
              "custom_fields.custom_label",
              "custom_fields.custom_label_position",
              "custom_fields.date_value",
              "custom_fields.date_value.date",
              "custom_fields.date_value.date_time",
              "custom_fields.default_access_level",
              "custom_fields.description",
              "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.format",
              "custom_fields.has_notifications_enabled",
              "custom_fields.html_text_value",
              "custom_fields.id_prefix",
              "custom_fields.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_global_to_workspace",
              "custom_fields.is_lookup_field",
              "custom_fields.is_value_read_only",
              "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.people_value",
              "custom_fields.people_value.name",
              "custom_fields.precision",
              "custom_fields.privacy_setting",
              "custom_fields.reference_value",
              "custom_fields.reference_value.name",
              "custom_fields.representation_type",
              "custom_fields.resource_subtype",
              "custom_fields.text_value",
              "custom_fields.type",
              "default_access_level",
              "deleted_at",
              "is_in_archived_table",
              "modified_at",
              "name",
              "permalink_url",
              "table",
              "table.name",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "comment_count",
                  "created_at",
                  "created_by",
                  "created_by.name",
                  "custom_fields",
                  "custom_fields.asana_created_field",
                  "custom_fields.created_by",
                  "custom_fields.created_by.name",
                  "custom_fields.currency_code",
                  "custom_fields.custom_label",
                  "custom_fields.custom_label_position",
                  "custom_fields.date_value",
                  "custom_fields.date_value.date",
                  "custom_fields.date_value.date_time",
                  "custom_fields.default_access_level",
                  "custom_fields.description",
                  "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.format",
                  "custom_fields.has_notifications_enabled",
                  "custom_fields.html_text_value",
                  "custom_fields.id_prefix",
                  "custom_fields.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_global_to_workspace",
                  "custom_fields.is_lookup_field",
                  "custom_fields.is_value_read_only",
                  "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.people_value",
                  "custom_fields.people_value.name",
                  "custom_fields.precision",
                  "custom_fields.privacy_setting",
                  "custom_fields.reference_value",
                  "custom_fields.reference_value.name",
                  "custom_fields.representation_type",
                  "custom_fields.resource_subtype",
                  "custom_fields.text_value",
                  "custom_fields.type",
                  "default_access_level",
                  "deleted_at",
                  "is_in_archived_table",
                  "modified_at",
                  "name",
                  "permalink_url",
                  "table",
                  "table.name",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/RecordItemCompact"
                          },
                          "type": "array"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__RecordItemResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the matching records."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "records:read"
            ]
          }
        ],
        "summary": "Search records in a workspace",
        "tags": [
          "Records"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}~1records~1search/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet recordsApiInstance = new Asana.RecordsApi(client);\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\nlet opts = { \n    'limit': 50, \n    'text': \"Renewal\", \n    'teams.any': \"12345,23456,34567\", \n    'followers.any': \"12345,23456,34567\", \n    'followers.not': \"12345,23456,34567\", \n    'tables.any': \"12345,23456,34567\", \n    'tables.not': \"12345,23456,34567\", \n    'tables.all': \"12345,23456,34567\", \n    'created_on.before': \"2019-09-15\", \n    'created_on.after': \"2019-09-15\", \n    'created_on': \"2019-09-15\", \n    'created_at.before': \"2019-04-15T01:01:46.055Z\", \n    'created_at.after': \"2019-04-15T01:01:46.055Z\", \n    'sort_by': \"modified_at\", \n    'sort_ascending': false, \n    'opt_fields': \"comment_count,created_at,created_by,created_by.name,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,deleted_at,is_in_archived_table,modified_at,name,permalink_url,table,table.name,workspace,workspace.name\"\n};\nrecordsApiInstance.searchRecordsForWorkspace(workspace_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nrecords_api_instance = asana.RecordsApi(api_client)\nworkspace_gid = \"12345\" # str | Globally unique identifier for the workspace or organization.\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    'text': \"Renewal\", # str | Performs full-text search on the record name\n    'teams.any': \"12345,23456,34567\", # str | Comma-separated list of team IDs\n    'followers.any': \"12345,23456,34567\", # str | Comma-separated list of user identifiers. This can either be the string \\\"me\\\", an email, or the gid of a user.\n    'followers.not': \"12345,23456,34567\", # str | Comma-separated list of user identifiers. This can either be the string \\\"me\\\", an email, or the gid of a user.\n    'tables.any': \"12345,23456,34567\", # str | Comma-separated list of table IDs\n    'tables.not': \"12345,23456,34567\", # str | Comma-separated list of table IDs\n    'tables.all': \"12345,23456,34567\", # str | Comma-separated list of table IDs\n    'created_on.before': '2019-09-15', # date | ISO 8601 date string\n    'created_on.after': '2019-09-15', # date | ISO 8601 date string\n    'created_on': '2019-09-15', # date | ISO 8601 date string or `null`\n    'created_at.before': '2019-04-15T01:01:46.055Z', # datetime | ISO 8601 datetime string\n    'created_at.after': '2019-04-15T01:01:46.055Z', # datetime | ISO 8601 datetime string\n    'sort_by': \"modified_at\", # str | One of `created_at` or `modified_at`, defaults to `modified_at`\n    'sort_ascending': True, # bool | Default `false`\n    'opt_fields': \"comment_count,created_at,created_by,created_by.name,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,deleted_at,is_in_archived_table,modified_at,name,permalink_url,table,table.name,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Search records in a workspace\n    api_response = records_api_instance.search_records_for_workspace(workspace_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling RecordsApi->search_records_for_workspace: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/workspace_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "description": "Performs full-text search on the record name",
          "example": "Renewal",
          "in": "query",
          "name": "text",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of team IDs",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "teams.any",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of user identifiers. This can either be the string \"me\", an email, or the gid of a user.",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "followers.any",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of user identifiers. This can either be the string \"me\", an email, or the gid of a user.",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "followers.not",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of table IDs",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "tables.any",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of table IDs",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "tables.not",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of table IDs",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "tables.all",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string",
          "example": "2019-09-15",
          "in": "query",
          "name": "created_on.before",
          "schema": {
            "format": "date",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string",
          "example": "2019-09-15",
          "in": "query",
          "name": "created_on.after",
          "schema": {
            "format": "date",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string or `null`",
          "example": "2019-09-15",
          "in": "query",
          "name": "created_on",
          "schema": {
            "format": "date",
            "nullable": true,
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 datetime string",
          "example": "2019-04-15T01:01:46.055Z",
          "in": "query",
          "name": "created_at.before",
          "schema": {
            "format": "date-time",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 datetime string",
          "example": "2019-04-15T01:01:46.055Z",
          "in": "query",
          "name": "created_at.after",
          "schema": {
            "format": "date-time",
            "type": "string"
          }
        },
        {
          "description": "One of `created_at` or `modified_at`, defaults to `modified_at`",
          "example": "modified_at",
          "in": "query",
          "name": "sort_by",
          "schema": {
            "default": "modified_at",
            "enum": [
              "created_at",
              "modified_at"
            ],
            "type": "string"
          }
        },
        {
          "description": "Default `false`",
          "example": true,
          "in": "query",
          "name": "sort_ascending",
          "schema": {
            "default": false,
            "type": "boolean"
          }
        }
      ]
    },
    "/workspaces/{workspace_gid}/removeUser": {
      "parameters": [
        {
          "$ref": "#/components/parameters/workspace_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "Remove a user from a workspace or organization.\n\nThe user making this call must be an admin in the workspace. The user can\nbe referenced by their globally unique user ID or their email address.\n\nWhen invoked using a **Service Account Token (SAT)**, this endpoint follows the same behavior as the\n[SCIM API Delete endpoint](/docs/scim).\nTo learn more about how Asana handles user deprovisioning, refer to our\n[Help Center article on deprovisioning users](https://help.asana.com/s/article/user-deprovisioning).\n\nWhen invoked using a **Personal Access Token (PAT)**, the endpoint behaves similarly, except that\nownership of the user’s resources is transferred to the **PAT owner** instead of the admin\n[specified in the Admin Console](https://help.asana.com/s/article/user-deprovisioning#gl-deprovisioning).\n\n**Note:** If you wish to retain access to a user’s private resources\n(i.e., those visible only to that user), you have to make them public manually\n(or ask the user to do so) before removal.\n\nReturns an empty data record.",
        "operationId": "removeUserForWorkspace",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/WorkspaceRemoveUserRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The user to remove from the workspace.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EmptyResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__EmptyResponseData"
                    }
                  ]
                }
              }
            },
            "description": "The user was removed successfully to the workspace or organization."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Remove a user from a workspace or organization",
        "tags": [
          "Workspaces"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}~1removeUser/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nJsonElement result = client.workspaces.removeUserForWorkspace(workspaceGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet workspacesApiInstance = new Asana.WorkspacesApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The user to remove from the workspace.\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\n\nworkspacesApiInstance.removeUserForWorkspace(body, workspace_gid).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.workspaces.removeUserForWorkspace(workspaceGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nworkspaces_api_instance = asana.WorkspacesApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The user to remove from the workspace.\nworkspace_gid = \"12345\" # str | Globally unique identifier for the workspace or organization.\n\n\ntry:\n    # Remove a user from a workspace or organization\n    api_response = workspaces_api_instance.remove_user_for_workspace(body, workspace_gid)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling WorkspacesApi->remove_user_for_workspace: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.workspaces.remove_user_for_workspace(workspace_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->workspaces->removeUserForWorkspace($workspace_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.workspaces.remove_user_for_workspace(workspace_gid: 'workspace_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/workspaces/{workspace_gid}/tables": {
      "get": {
        "description": "<b>Required scope: </b><code>tables:read</code>\n\nReturns the compact table records for all tables in the given workspace.",
        "operationId": "getTablesForWorkspace",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_at",
              "custom_field_settings",
              "custom_field_settings.custom_field",
              "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.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.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.representation_type",
              "custom_field_settings.custom_field.text_value",
              "custom_field_settings.custom_field.type",
              "custom_field_settings.is_important",
              "default_access_level",
              "modified_at",
              "name",
              "offset",
              "path",
              "uri",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_at",
                  "custom_field_settings",
                  "custom_field_settings.custom_field",
                  "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.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.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.representation_type",
                  "custom_field_settings.custom_field.text_value",
                  "custom_field_settings.custom_field.type",
                  "custom_field_settings.is_important",
                  "default_access_level",
                  "modified_at",
                  "name",
                  "offset",
                  "path",
                  "uri",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TableCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TableResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested workspace's tables."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tables:read"
            ]
          }
        ],
        "summary": "Get tables in a workspace",
        "tags": [
          "Tables"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}~1tables/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tablesApiInstance = new Asana.TablesApi(client);\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"created_at,custom_field_settings,custom_field_settings.custom_field,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.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.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_lookup_field,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.representation_type,custom_field_settings.custom_field.text_value,custom_field_settings.custom_field.type,custom_field_settings.is_important,modified_at,name,offset,path,uri,workspace,workspace.name\"\n};\ntablesApiInstance.getTablesForWorkspace(workspace_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\ntables_api_instance = asana.TablesApi(api_client)\nworkspace_gid = \"12345\" # str | Globally unique identifier for the workspace or organization.\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    'opt_fields': \"created_at,custom_field_settings,custom_field_settings.custom_field,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.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.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_lookup_field,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.representation_type,custom_field_settings.custom_field.text_value,custom_field_settings.custom_field.type,custom_field_settings.is_important,modified_at,name,offset,path,uri,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get tables in a workspace\n    api_response = tables_api_instance.get_tables_for_workspace(workspace_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TablesApi->get_tables_for_workspace: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/workspace_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/workspaces/{workspace_gid}/tags": {
      "get": {
        "description": "<b>Required scope: </b><code>tags:read</code>\n\nReturns the compact tag records for some filtered set of tags. Use one or more of the parameters provided to filter the tags returned.",
        "operationId": "getTagsForWorkspace",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/offset"
          },
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "color",
              "created_at",
              "followers",
              "followers.name",
              "name",
              "notes",
              "offset",
              "path",
              "permalink_url",
              "uri",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "color",
                  "created_at",
                  "followers",
                  "followers.name",
                  "name",
                  "notes",
                  "offset",
                  "path",
                  "permalink_url",
                  "uri",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TagCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TagResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the specified set of tags."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tags:read"
            ]
          }
        ],
        "summary": "Get tags in a workspace",
        "tags": [
          "Tags"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}~1tags/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Tag> result = client.tags.getTagsForWorkspace(workspaceGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tagsApiInstance = new Asana.TagsApi(client);\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"color,created_at,followers,followers.name,name,notes,offset,path,permalink_url,uri,workspace,workspace.name\"\n};\ntagsApiInstance.getTagsForWorkspace(workspace_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tags.getTagsForWorkspace(workspaceGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntags_api_instance = asana.TagsApi(api_client)\nworkspace_gid = \"12345\" # str | Globally unique identifier for the workspace or organization.\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    'opt_fields': \"color,created_at,followers,followers.name,name,notes,offset,path,permalink_url,uri,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get tags in a workspace\n    api_response = tags_api_instance.get_tags_for_workspace(workspace_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TagsApi->get_tags_for_workspace: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tags.get_tags_for_workspace(workspace_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tags->getTagsForWorkspace($workspace_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tags.get_tags_for_workspace(workspace_gid: 'workspace_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/workspace_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "post": {
        "description": "<b>Required scope: </b><code>tags:write</code>\n\nCreates a new tag in a workspace or organization.\n\nEvery tag is required to be created in a specific workspace or\norganization, and this cannot be changed once set. Note that you can use\nthe workspace parameter regardless of whether or not it is an\norganization.\n\nReturns the full record of the newly created tag.",
        "operationId": "createTagForWorkspace",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "color",
              "created_at",
              "followers",
              "followers.name",
              "name",
              "notes",
              "permalink_url",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "color",
                  "created_at",
                  "followers",
                  "followers.name",
                  "name",
                  "notes",
                  "permalink_url",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TagCreateTagForWorkspaceRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The tag to create.",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TagResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TagResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully created the newly specified tag."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tags:write"
            ]
          }
        ],
        "summary": "Create a tag in a workspace",
        "tags": [
          "Tags"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}~1tags/post",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nTag result = client.tags.createTagForWorkspace(workspaceGid)\n    .data(\"field\", \"value\")\n    .data(\"field\", \"value\")\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tagsApiInstance = new Asana.TagsApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The tag to create.\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\nlet opts = { \n    'opt_fields': \"color,created_at,followers,followers.name,name,notes,permalink_url,workspace,workspace.name\"\n};\ntagsApiInstance.createTagForWorkspace(body, workspace_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tags.createTagForWorkspace(workspaceGid, {field: \"value\", field: \"value\", pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntags_api_instance = asana.TagsApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The tag to create.\nworkspace_gid = \"12345\" # str | Globally unique identifier for the workspace or organization.\nopts = {\n    'opt_fields': \"color,created_at,followers,followers.name,name,notes,permalink_url,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Create a tag in a workspace\n    api_response = tags_api_instance.create_tag_for_workspace(body, workspace_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling TagsApi->create_tag_for_workspace: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tags.create_tag_for_workspace(workspace_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tags->createTagForWorkspace($workspace_gid, array('field' => 'value', 'field' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tags.create_tag_for_workspace(workspace_gid: 'workspace_gid', field: \"value\", field: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      }
    },
    "/workspaces/{workspace_gid}/tasks/custom_id/{custom_id}": {
      "get": {
        "description": "<b>Required scope: </b><code>tasks:read</code>\n\n<table>\n  <tr>\n    <th>Field</th>\n    <th>Required Scope</th>\n  </tr>\n  <tr>\n    <td><code>memberships</code></td>\n    <td><code>projects:read</code>, <code>project_sections:read</code></td>\n  </tr>\n  <tr>\n    <td><code>effective_memberships</code></td>\n    <td><code>projects:read</code>, <code>project_sections:read</code></td>\n  </tr>\n  <tr>\n    <td><code>custom_type</code></td>\n    <td><code>custom_types:read</code></td>\n  </tr>\n  <tr>\n    <td><code>custom_type_status_option</code></td>\n    <td><code>custom_types:read</code></td>\n  </tr>\n  <tr>\n    <td><code>actual_time_minutes</code></td>\n    <td><code>time_tracking_entries:read</code></td>\n  </tr>\n</table>\n\nReturns a task given a custom ID shortcode.",
        "operationId": "getTaskForCustomID",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TaskResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TaskResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved task for given custom ID."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:read"
            ]
          }
        ],
        "summary": "Get a task for a given custom ID",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}~1tasks~1custom_id~1{custom_id}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\nlet custom_id = \"EX-1\"; // String | Generated custom ID for a task.\n\ntasksApiInstance.getTaskForCustomID(workspace_gid, custom_id).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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.getTaskForCustomID(workspaceGid, customId, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/workspace_path_gid"
        },
        {
          "$ref": "#/components/parameters/custom_id"
        }
      ]
    },
    "/workspaces/{workspace_gid}/tasks/search": {
      "get": {
        "description": "<b>Required scope: </b><code>tasks:read</code>\n\nTo mirror the functionality of the Asana web app's advanced search feature, the Asana API has a task search endpoint that allows you to build complex filters to find and retrieve the exact data you need.\n#### Premium access\nLike the Asana web product's advance search feature, this search endpoint will only be available to premium Asana users. A user is premium if any of the following is true:\n\n- The workspace in which the search is being performed is a premium workspace\n- The user is a member of a premium team inside the workspace\n\nEven if a user is only a member of a premium team inside a non-premium workspace, search will allow them to find data anywhere in the workspace, not just inside the premium team. Making a search request using credentials of a non-premium user will result in a `402 Payment Required` error.\n#### Pagination\nSearch results are not stable; repeating the same query multiple times may return the data in a different order, even if the data do not change. Because of this, the traditional [pagination](/docs/pagination) available elsewhere in the Asana API is not available here. However, you can paginate manually by sorting the search results by their creation time and then modifying each subsequent query to exclude data you have already seen. Page sizes are limited to a maximum of 100 items, and can be specified by the `limit` query parameter.\n#### Eventual consistency\nChanges in Asana (regardless of whether they’re made though the web product or the API) are forwarded to our search infrastructure to be indexed. This process can take between 10 and 60 seconds to complete under normal operation, and longer during some production incidents. Making a change to a task that would alter its presence in a particular search query will not be reflected immediately. This is also true of the advanced search feature in the web product.\nBecause of this delay, the search endpoint is not suited for use cases that require immediate consistency after writes. If you need read-your-write behavior or strongly consistent results, we recommend using [Get multiple tasks](/reference/gettasks) instead.\n#### Rate limits\nYou may receive a `429 Too Many Requests` response if you hit any of our [rate limits](/docs/rate-limits).\n#### Custom field parameters\n| Parameter name | Custom field type | Accepted type |\n|---|---|---|\n| custom_fields.{gid}.is_set | All | Boolean |\n| custom_fields.{gid}.value | Text | String |\n| custom_fields.{gid}.value | Number | Number |\n| custom_fields.{gid}.value | Enum | Enum option ID |\n| custom_fields.{gid}.value | Date | ISO 8601 date string (yyyy-mm-dd) |\n| custom_fields.{gid}.starts_with | Text only | String |\n| custom_fields.{gid}.ends_with | Text only | String |\n| custom_fields.{gid}.contains | Text only | String |\n| custom_fields.{gid}.less_than | Number only | Number |\n| custom_fields.{gid}.greater_than | Number only | Number |\n| custom_fields.{gid}.before | Date only | ISO 8601 date string (yyyy-mm-dd) |\n| custom_fields.{gid}.after | Date only | ISO 8601 date string (yyyy-mm-dd) |\n\n\nFor example, if the gid of the custom field is 12345, the query parameter to find tasks where it is set would be `custom_fields.12345.is_set=true`. To match an exact value for an enum custom field, use the gid of the desired enum option and not the name of the enum option: `custom_fields.12345.value=67890`. To find tasks with a date custom field before April 21, 2026, use `custom_fields.12345.before=2026-04-21`.\n\n**Not Supported**: searching for multiple exact matches of a custom field, searching for multi-enum custom field\n\n#### Custom task type parameters\n| Parameter name | Accepted type |\n|---|---|\n| custom_types.{gid}.custom_type_status_option.gid | Enum option GID |\n\nThis parameter filters tasks by their custom task status option. The `{gid}` is the GID of the custom task type, and the value is the GID of a valid status option for that type's status field.\n\n**Requirements**:\n- `resource_subtype=custom` must be set when using this parameter.\n- Only one `custom_types.*` parameter may be specified per request.\n- The provided custom task type GID must reference a valid custom object type.\n- The status option GID must be a valid option for the custom type's status field.\n- Cannot be combined with `custom_fields.{status_field_gid}.value` when `{status_field_gid}` is the status field belonging to the same custom task type.\n\nFor example, to find custom tasks of type `12345` with status option `67890`: `custom_types.12345.custom_type_status_option.gid=67890&resource_subtype=custom`.\n\n*Note: If you specify `projects.any` and `sections.any`, you will receive tasks for the project **and** tasks for the section. If you're looking for only tasks in a section, omit the `projects.any` from the request.*",
        "operationId": "searchTasksForWorkspace",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "actual_time_minutes",
              "approval_status",
              "assigned_by",
              "assigned_by.name",
              "assignee",
              "assignee.name",
              "assignee_section",
              "assignee_section.name",
              "assignee_status",
              "completed",
              "completed_at",
              "completed_by",
              "completed_by.name",
              "created_at",
              "created_by",
              "custom_fields",
              "custom_fields.asana_created_field",
              "custom_fields.created_by",
              "custom_fields.created_by.name",
              "custom_fields.currency_code",
              "custom_fields.custom_label",
              "custom_fields.custom_label_position",
              "custom_fields.date_value",
              "custom_fields.date_value.date",
              "custom_fields.date_value.date_time",
              "custom_fields.default_access_level",
              "custom_fields.description",
              "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.format",
              "custom_fields.has_notifications_enabled",
              "custom_fields.html_text_value",
              "custom_fields.id_prefix",
              "custom_fields.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_global_to_workspace",
              "custom_fields.is_lookup_field",
              "custom_fields.is_value_read_only",
              "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.people_value",
              "custom_fields.people_value.name",
              "custom_fields.precision",
              "custom_fields.privacy_setting",
              "custom_fields.reference_value",
              "custom_fields.reference_value.name",
              "custom_fields.representation_type",
              "custom_fields.resource_subtype",
              "custom_fields.text_value",
              "custom_fields.type",
              "custom_type",
              "custom_type.asana_created_type_identifier",
              "custom_type.name",
              "custom_type_status_option",
              "custom_type_status_option.name",
              "dependencies",
              "dependents",
              "due_at",
              "due_on",
              "effective_memberships",
              "external",
              "external.data",
              "followers",
              "followers.name",
              "has_subtasks_date_mismatch",
              "hearted",
              "hearts",
              "hearts.user",
              "hearts.user.name",
              "html_notes",
              "is_rendered_as_separator",
              "liked",
              "likes",
              "likes.user",
              "likes.user.name",
              "memberships",
              "memberships.project",
              "memberships.project.name",
              "memberships.project.resource_subtype",
              "memberships.section",
              "memberships.section.name",
              "modified_at",
              "name",
              "notes",
              "num_hearts",
              "num_likes",
              "num_subtasks",
              "parent",
              "parent.created_by",
              "parent.name",
              "parent.resource_subtype",
              "permalink_url",
              "projects",
              "projects.name",
              "projects.resource_subtype",
              "resource_subtype",
              "start_at",
              "start_on",
              "tags",
              "tags.name",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "actual_time_minutes",
                  "approval_status",
                  "assigned_by",
                  "assigned_by.name",
                  "assignee",
                  "assignee.name",
                  "assignee_section",
                  "assignee_section.name",
                  "assignee_status",
                  "completed",
                  "completed_at",
                  "completed_by",
                  "completed_by.name",
                  "created_at",
                  "created_by",
                  "custom_fields",
                  "custom_fields.asana_created_field",
                  "custom_fields.created_by",
                  "custom_fields.created_by.name",
                  "custom_fields.currency_code",
                  "custom_fields.custom_label",
                  "custom_fields.custom_label_position",
                  "custom_fields.date_value",
                  "custom_fields.date_value.date",
                  "custom_fields.date_value.date_time",
                  "custom_fields.default_access_level",
                  "custom_fields.description",
                  "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.format",
                  "custom_fields.has_notifications_enabled",
                  "custom_fields.html_text_value",
                  "custom_fields.id_prefix",
                  "custom_fields.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_global_to_workspace",
                  "custom_fields.is_lookup_field",
                  "custom_fields.is_value_read_only",
                  "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.people_value",
                  "custom_fields.people_value.name",
                  "custom_fields.precision",
                  "custom_fields.privacy_setting",
                  "custom_fields.reference_value",
                  "custom_fields.reference_value.name",
                  "custom_fields.representation_type",
                  "custom_fields.resource_subtype",
                  "custom_fields.text_value",
                  "custom_fields.type",
                  "custom_type",
                  "custom_type.asana_created_type_identifier",
                  "custom_type.name",
                  "custom_type_status_option",
                  "custom_type_status_option.name",
                  "dependencies",
                  "dependents",
                  "due_at",
                  "due_on",
                  "effective_memberships",
                  "external",
                  "external.data",
                  "followers",
                  "followers.name",
                  "has_subtasks_date_mismatch",
                  "hearted",
                  "hearts",
                  "hearts.user",
                  "hearts.user.name",
                  "html_notes",
                  "is_rendered_as_separator",
                  "liked",
                  "likes",
                  "likes.user",
                  "likes.user.name",
                  "memberships",
                  "memberships.project",
                  "memberships.project.name",
                  "memberships.project.resource_subtype",
                  "memberships.section",
                  "memberships.section.name",
                  "modified_at",
                  "name",
                  "notes",
                  "num_hearts",
                  "num_likes",
                  "num_subtasks",
                  "parent",
                  "parent.created_by",
                  "parent.name",
                  "parent.resource_subtype",
                  "permalink_url",
                  "projects",
                  "projects.name",
                  "projects.resource_subtype",
                  "resource_subtype",
                  "start_at",
                  "start_on",
                  "tags",
                  "tags.name",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TaskCompact"
                          },
                          "type": "array"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TaskResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the section's tasks."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "tasks:read"
            ]
          }
        ],
        "summary": "Search tasks in a workspace",
        "tags": [
          "Tasks"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}~1tasks~1search/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Task> result = client.tasks.searchTasksForWorkspace(workspaceGid, sortAscending, sortBy, isSubtask, completed, hasAttachment, isBlocked, isBlocking, modifiedAtAfter, modifiedAtBefore, dueOn, modifiedOn, modifiedOnAfter, modifiedOnBefore, completedAtAfter, completedAtBefore, completedOn, completedOnAfter, completedOnBefore, createdAtAfter, dueOnAfter, createdAtBefore, createdOn, createdOnAfter, createdOnBefore, startOn, startOnAfter, startOnBefore, dueAtAfter, dueAtBefore, dueOnBefore, commentedOnByNot, likedByNot, assignedByNot, assignedByAny, createdByNot, createdByAny, followersNot, teamsAny, tagsAll, tagsNot, tagsAny, sectionsAll, sectionsNot, sectionsAny, projectsAll, projectsNot, projectsAny, portfoliosAny, assigneeNot, assigneeAny, resourceSubtype, text)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet tasksApiInstance = new Asana.TasksApi(client);\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\nlet opts = { \n    'limit': 50, \n    'text': \"Bug\", \n    'resource_subtype': \"milestone\", \n    'assignee.any': \"12345,23456,34567\", \n    'assignee.not': \"12345,23456,34567\", \n    'portfolios.any': \"12345,23456,34567\", \n    'projects.any': \"12345,23456,34567\", \n    'projects.not': \"12345,23456,34567\", \n    'projects.all': \"12345,23456,34567\", \n    'sections.any': \"12345,23456,34567\", \n    'sections.not': \"12345,23456,34567\", \n    'sections.all': \"12345,23456,34567\", \n    'tags.any': \"12345,23456,34567\", \n    'tags.not': \"12345,23456,34567\", \n    'tags.all': \"12345,23456,34567\", \n    'teams.any': \"12345,23456,34567\", \n    'followers.any': \"12345,23456,34567\", \n    'followers.not': \"12345,23456,34567\", \n    'created_by.any': \"12345,23456,34567\", \n    'created_by.not': \"12345,23456,34567\", \n    'assigned_by.any': \"12345,23456,34567\", \n    'assigned_by.not': \"12345,23456,34567\", \n    'liked_by.not': \"12345,23456,34567\", \n    'commented_on_by.not': \"12345,23456,34567\", \n    'due_on.before': \"2019-09-15\", \n    'due_on.after': \"2019-09-15\", \n    'due_on': \"2019-09-15\", \n    'due_at.before': \"2019-04-15T01:01:46.055Z\", \n    'due_at.after': \"2019-04-15T01:01:46.055Z\", \n    'start_on.before': \"2019-09-15\", \n    'start_on.after': \"2019-09-15\", \n    'start_on': \"2019-09-15\", \n    'created_on.before': \"2019-09-15\", \n    'created_on.after': \"2019-09-15\", \n    'created_on': \"2019-09-15\", \n    'created_at.before': \"2019-04-15T01:01:46.055Z\", \n    'created_at.after': \"2019-04-15T01:01:46.055Z\", \n    'completed_on.before': \"2019-09-15\", \n    'completed_on.after': \"2019-09-15\", \n    'completed_on': \"2019-09-15\", \n    'completed_at.before': \"2019-04-15T01:01:46.055Z\", \n    'completed_at.after': \"2019-04-15T01:01:46.055Z\", \n    'modified_on.before': \"2019-09-15\", \n    'modified_on.after': \"2019-09-15\", \n    'modified_on': \"2019-09-15\", \n    'modified_at.before': \"2019-04-15T01:01:46.055Z\", \n    'modified_at.after': \"2019-04-15T01:01:46.055Z\", \n    'is_blocking': false, \n    'is_blocked': false, \n    'has_attachment': false, \n    'completed': false, \n    'is_subtask': false, \n    'sort_by': \"modified_at\", \n    'sort_ascending': false, \n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,parent,parent.created_by,parent.name,parent.resource_subtype,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,workspace,workspace.name\"\n};\n// Custom fields query\nopts['custom_fields.123.is_set'] = true; // Boolean | Replace \"123\" with <YOUR_CUSTOM_FIELD_GID>. NOTE: searching for multiple exact matches of a custom field, searching for multi-enum custom field\nopts['custom_fields.123.value'] = '456'; // String, Number, Enum option ID | Replace \"123\" with <YOUR_CUSTOM_FIELD_GID>. NOTE: searching for multiple exact matches of a custom field, searching for multi-enum custom field\nopts['custom_fields.123.starts_with'] = 'start'; // String | Replace \"123\" with <YOUR_CUSTOM_FIELD_GID>. NOTE: searching for multiple exact matches of a custom field, searching for multi-enum custom field\nopts['custom_fields.123.ends_with'] = 'end'; // String | Replace \"123\" with <YOUR_CUSTOM_FIELD_GID>. NOTE: searching for multiple exact matches of a custom field, searching for multi-enum custom field\nopts['custom_fields.123.contains'] = 'first'; // String | Replace \"123\" with <YOUR_CUSTOM_FIELD_GID>. NOTE: searching for multiple exact matches of a custom field, searching for multi-enum custom field\nopts['custom_fields.123.less_than'] = 10; // Number | Replace \"123\" with <YOUR_CUSTOM_FIELD_GID>. NOTE: searching for multiple exact matches of a custom field, searching for multi-enum custom field\nopts['custom_fields.123.greater_than'] = 100; // Number | Replace \"123\" with <YOUR_CUSTOM_FIELD_GID>. NOTE: searching for multiple exact matches of a custom field, searching for multi-enum custom field\ntasksApiInstance.searchTasksForWorkspace(workspace_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.tasks.searchTasksForWorkspace(workspaceGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntasks_api_instance = asana.TasksApi(api_client)\nworkspace_gid = \"12345\" # str | Globally unique identifier for the workspace or organization.\nopts = {\n    'limit': 50, # int | Results per search response. The number of objects to return in one search response. The value must be between 1 and 100. Search responses have no `next_page`, so to retrieve further results, sort by `created_at` and repeat the query with a `created_at.before` or `created_at.after` filter that excludes the results you have already seen.\n    'text': \"Bug\", # str | Performs full-text search on both task name and description\n    'resource_subtype': \"milestone\", # str | Filters results by the task's resource_subtype\n    'assignee.any': \"12345,23456,34567\", # str | Comma-separated list of user identifiers. This can either be the string \\\"me\\\", an email, or the gid of a user.\n    'assignee.not': \"12345,23456,34567\", # str | Comma-separated list of user identifiers. This can either be the string \\\"me\\\", an email, or the gid of a user.\n    'portfolios.any': \"12345,23456,34567\", # str | Comma-separated list of portfolio IDs\n    'projects.any': \"12345,23456,34567\", # str | Comma-separated list of project IDs. Returns tasks that are directly in these projects or inherit them from an ancestor task.\n    'projects.not': \"12345,23456,34567\", # str | Comma-separated list of project IDs\n    'projects.all': \"12345,23456,34567\", # str | Comma-separated list of project IDs\n    'sections.any': \"12345,23456,34567\", # str | Comma-separated list of section or column IDs\n    'sections.not': \"12345,23456,34567\", # str | Comma-separated list of section or column IDs\n    'sections.all': \"12345,23456,34567\", # str | Comma-separated list of section or column IDs\n    'tags.any': \"12345,23456,34567\", # str | Comma-separated list of tag IDs\n    'tags.not': \"12345,23456,34567\", # str | Comma-separated list of tag IDs\n    'tags.all': \"12345,23456,34567\", # str | Comma-separated list of tag IDs\n    'teams.any': \"12345,23456,34567\", # str | Comma-separated list of team IDs\n    'followers.any': \"12345,23456,34567\", # str | Comma-separated list of user identifiers. This can either be the string \\\"me\\\", an email, or the gid of a user.\n    'followers.not': \"12345,23456,34567\", # str | Comma-separated list of user identifiers. This can either be the string \\\"me\\\", an email, or the gid of a user.\n    'created_by.any': \"12345,23456,34567\", # str | Comma-separated list of user identifiers. This can either be the string \\\"me\\\", an email, or the gid of a user.\n    'created_by.not': \"12345,23456,34567\", # str | Comma-separated list of user identifiers. This can either be the string \\\"me\\\", an email, or the gid of a user.\n    'assigned_by.any': \"12345,23456,34567\", # str | Comma-separated list of user identifiers. This can either be the string \\\"me\\\", an email, or the gid of a user.\n    'assigned_by.not': \"12345,23456,34567\", # str | Comma-separated list of user identifiers. This can either be the string \\\"me\\\", an email, or the gid of a user.\n    'liked_by.not': \"12345,23456,34567\", # str | Comma-separated list of user identifiers. This can either be the string \\\"me\\\", an email, or the gid of a user.\n    'commented_on_by.not': \"12345,23456,34567\", # str | Comma-separated list of user identifiers. This can either be the string \\\"me\\\", an email, or the gid of a user.\n    'due_on.before': '2019-09-15', # date | ISO 8601 date string\n    'due_on.after': '2019-09-15', # date | ISO 8601 date string\n    'due_on': '2019-09-15', # date | ISO 8601 date string or `null`\n    'due_at.before': '2019-04-15T01:01:46.055Z', # datetime | ISO 8601 datetime string\n    'due_at.after': '2019-04-15T01:01:46.055Z', # datetime | ISO 8601 datetime string\n    'start_on.before': '2019-09-15', # date | ISO 8601 date string\n    'start_on.after': '2019-09-15', # date | ISO 8601 date string\n    'start_on': '2019-09-15', # date | ISO 8601 date string or `null`\n    'created_on.before': '2019-09-15', # date | ISO 8601 date string\n    'created_on.after': '2019-09-15', # date | ISO 8601 date string\n    'created_on': '2019-09-15', # date | ISO 8601 date string or `null`\n    'created_at.before': '2019-04-15T01:01:46.055Z', # datetime | ISO 8601 datetime string\n    'created_at.after': '2019-04-15T01:01:46.055Z', # datetime | ISO 8601 datetime string\n    'completed_on.before': '2019-09-15', # date | ISO 8601 date string\n    'completed_on.after': '2019-09-15', # date | ISO 8601 date string\n    'completed_on': '2019-09-15', # date | ISO 8601 date string or `null`\n    'completed_at.before': '2019-04-15T01:01:46.055Z', # datetime | ISO 8601 datetime string\n    'completed_at.after': '2019-04-15T01:01:46.055Z', # datetime | ISO 8601 datetime string\n    'modified_on.before': '2019-09-15', # date | ISO 8601 date string\n    'modified_on.after': '2019-09-15', # date | ISO 8601 date string\n    'modified_on': '2019-09-15', # date | ISO 8601 date string or `null`\n    'modified_at.before': '2019-04-15T01:01:46.055Z', # datetime | ISO 8601 datetime string\n    'modified_at.after': '2019-04-15T01:01:46.055Z', # datetime | ISO 8601 datetime string\n    'is_blocking': False, # bool | Filter to incomplete tasks with dependents\n    'is_blocked': False, # bool | Filter to tasks with incomplete dependencies\n    'has_attachment': False, # bool | Filter to tasks with attachments\n    'completed': False, # bool | Filter to completed tasks\n    'is_subtask': False, # bool | Filter to subtasks\n    'sort_by': \"modified_at\", # str | One of `due_date`, `created_at`, `completed_at`, `likes`, `relevance`, or `modified_at`, defaults to `modified_at`\n    'sort_ascending': True, # bool | Default `false`\n    'opt_fields': \"actual_time_minutes,approval_status,assigned_by,assigned_by.name,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.default_access_level,custom_fields.description,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.format,custom_fields.has_notifications_enabled,custom_fields.html_text_value,custom_fields.id_prefix,custom_fields.input_restrictions,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_lookup_field,custom_fields.is_value_read_only,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.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.privacy_setting,custom_fields.reference_value,custom_fields.reference_value.name,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,custom_type,custom_type.asana_created_type_identifier,custom_type.name,custom_type_status_option,custom_type_status_option.name,dependencies,dependents,due_at,due_on,effective_memberships,external,external.data,followers,followers.name,has_subtasks_date_mismatch,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.project.resource_subtype,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,parent,parent.created_by,parent.name,parent.resource_subtype,permalink_url,projects,projects.name,projects.resource_subtype,resource_subtype,start_at,start_on,tags,tags.name,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\nopts['custom_fields.123.is_set'] = True # bool | Filiter to tasks with custom field set or unset. Note: searching for multiple exact matches of a custom field, searching for multi-enum custom field\nopts['custom_fields.123.value'] = '456' # str or bool or Enum option ID | Filter to tasks with custom field that matches the provided value. Note: searching for multiple exact matches of a custom field, searching for multi-enum custom field\nopts['custom_fields.123.starts_with'] = 'start' # string | Filter to tasks with custom field that starts with provided string. Note: searching for multiple exact matches of a custom field, searching for multi-enum custom field\nopts['custom_fields.123.ends_with'] = 'end' # string | Filter to tasks with custom field that ends in provided string. Note: searching for multiple exact matches of a custom field, searching for multi-enum custom field\nopts['custom_fields.123.contains'] = 'first' # string | Filter to tasks with custom field that contains the provided string. Note: searching for multiple exact matches of a custom field, searching for multi-enum custom field\nopts['custom_fields.123.less_than'] = 10 # number | Filter to tasks with custom field with number value less than the provided number. Note: searching for multiple exact matches of a custom field, searching for multi-enum custom field\nopts['custom_fields.123.greater_than'] = 100 # number | Filter to tasks with custom field with number value greater than the provided number. Note: searching for multiple exact matches of a custom field, searching for multi-enum custom field\n\ntry:\n    # Search tasks in a workspace\n    api_response = tasks_api_instance.search_tasks_for_workspace(workspace_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TasksApi->search_tasks_for_workspace: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.tasks.search_tasks_for_workspace(workspace_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->tasks->searchTasksForWorkspace($workspace_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.tasks.search_tasks_for_workspace(workspace_gid: 'workspace_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/workspace_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/search_limit"
        },
        {
          "description": "Performs full-text search on both task name and description",
          "example": "Bug",
          "in": "query",
          "name": "text",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Filters results by the task's resource_subtype",
          "in": "query",
          "name": "resource_subtype",
          "schema": {
            "default": "milestone",
            "enum": [
              "default_task",
              "milestone",
              "approval",
              "custom"
            ],
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of user identifiers. This can either be the string \"me\", an email, or the gid of a user.",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "assignee.any",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of user identifiers. This can either be the string \"me\", an email, or the gid of a user.",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "assignee.not",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of portfolio IDs",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "portfolios.any",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of project IDs. Returns tasks that are directly in these projects or inherit them from an ancestor task.",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "projects.any",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of project IDs",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "projects.not",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of project IDs",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "projects.all",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of section or column IDs",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "sections.any",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of section or column IDs",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "sections.not",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of section or column IDs",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "sections.all",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of tag IDs",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "tags.any",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of tag IDs",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "tags.not",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of tag IDs",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "tags.all",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of team IDs",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "teams.any",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of user identifiers. This can either be the string \"me\", an email, or the gid of a user.",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "followers.any",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of user identifiers. This can either be the string \"me\", an email, or the gid of a user.",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "followers.not",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of user identifiers. This can either be the string \"me\", an email, or the gid of a user.",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "created_by.any",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of user identifiers. This can either be the string \"me\", an email, or the gid of a user.",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "created_by.not",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of user identifiers. This can either be the string \"me\", an email, or the gid of a user.",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "assigned_by.any",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of user identifiers. This can either be the string \"me\", an email, or the gid of a user.",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "assigned_by.not",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of user identifiers. This can either be the string \"me\", an email, or the gid of a user.",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "liked_by.not",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "Comma-separated list of user identifiers. This can either be the string \"me\", an email, or the gid of a user.",
          "example": "12345,23456,34567",
          "in": "query",
          "name": "commented_on_by.not",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string",
          "example": "2019-09-15",
          "in": "query",
          "name": "due_on.before",
          "schema": {
            "format": "date",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string",
          "example": "2019-09-15",
          "in": "query",
          "name": "due_on.after",
          "schema": {
            "format": "date",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string or `null`",
          "example": "2019-09-15",
          "in": "query",
          "name": "due_on",
          "schema": {
            "format": "date",
            "nullable": true,
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 datetime string",
          "example": "2019-04-15T01:01:46.055Z",
          "in": "query",
          "name": "due_at.before",
          "schema": {
            "format": "date-time",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 datetime string",
          "example": "2019-04-15T01:01:46.055Z",
          "in": "query",
          "name": "due_at.after",
          "schema": {
            "format": "date-time",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string",
          "example": "2019-09-15",
          "in": "query",
          "name": "start_on.before",
          "schema": {
            "format": "date",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string",
          "example": "2019-09-15",
          "in": "query",
          "name": "start_on.after",
          "schema": {
            "format": "date",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string or `null`",
          "example": "2019-09-15",
          "in": "query",
          "name": "start_on",
          "schema": {
            "format": "date",
            "nullable": true,
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string",
          "example": "2019-09-15",
          "in": "query",
          "name": "created_on.before",
          "schema": {
            "format": "date",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string",
          "example": "2019-09-15",
          "in": "query",
          "name": "created_on.after",
          "schema": {
            "format": "date",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string or `null`",
          "example": "2019-09-15",
          "in": "query",
          "name": "created_on",
          "schema": {
            "format": "date",
            "nullable": true,
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 datetime string",
          "example": "2019-04-15T01:01:46.055Z",
          "in": "query",
          "name": "created_at.before",
          "schema": {
            "format": "date-time",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 datetime string",
          "example": "2019-04-15T01:01:46.055Z",
          "in": "query",
          "name": "created_at.after",
          "schema": {
            "format": "date-time",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string",
          "example": "2019-09-15",
          "in": "query",
          "name": "completed_on.before",
          "schema": {
            "format": "date",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string",
          "example": "2019-09-15",
          "in": "query",
          "name": "completed_on.after",
          "schema": {
            "format": "date",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string or `null`",
          "example": "2019-09-15",
          "in": "query",
          "name": "completed_on",
          "schema": {
            "format": "date",
            "nullable": true,
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 datetime string",
          "example": "2019-04-15T01:01:46.055Z",
          "in": "query",
          "name": "completed_at.before",
          "schema": {
            "format": "date-time",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 datetime string",
          "example": "2019-04-15T01:01:46.055Z",
          "in": "query",
          "name": "completed_at.after",
          "schema": {
            "format": "date-time",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string",
          "example": "2019-09-15",
          "in": "query",
          "name": "modified_on.before",
          "schema": {
            "format": "date",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string",
          "example": "2019-09-15",
          "in": "query",
          "name": "modified_on.after",
          "schema": {
            "format": "date",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 date string or `null`",
          "example": "2019-09-15",
          "in": "query",
          "name": "modified_on",
          "schema": {
            "format": "date",
            "nullable": true,
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 datetime string",
          "example": "2019-04-15T01:01:46.055Z",
          "in": "query",
          "name": "modified_at.before",
          "schema": {
            "format": "date-time",
            "type": "string"
          }
        },
        {
          "description": "ISO 8601 datetime string",
          "example": "2019-04-15T01:01:46.055Z",
          "in": "query",
          "name": "modified_at.after",
          "schema": {
            "format": "date-time",
            "type": "string"
          }
        },
        {
          "description": "Filter to incomplete tasks with dependents",
          "example": false,
          "in": "query",
          "name": "is_blocking",
          "schema": {
            "type": "boolean"
          }
        },
        {
          "description": "Filter to tasks with incomplete dependencies",
          "example": false,
          "in": "query",
          "name": "is_blocked",
          "schema": {
            "type": "boolean"
          }
        },
        {
          "description": "Filter to tasks with attachments",
          "example": false,
          "in": "query",
          "name": "has_attachment",
          "schema": {
            "type": "boolean"
          }
        },
        {
          "description": "Filter to completed tasks",
          "example": false,
          "in": "query",
          "name": "completed",
          "schema": {
            "type": "boolean"
          }
        },
        {
          "description": "Filter to subtasks",
          "example": false,
          "in": "query",
          "name": "is_subtask",
          "schema": {
            "type": "boolean"
          }
        },
        {
          "description": "One of `due_date`, `created_at`, `completed_at`, `likes`, `relevance`, or `modified_at`, defaults to `modified_at`",
          "example": "likes",
          "in": "query",
          "name": "sort_by",
          "schema": {
            "default": "modified_at",
            "enum": [
              "due_date",
              "created_at",
              "completed_at",
              "likes",
              "modified_at",
              "relevance"
            ],
            "type": "string"
          }
        },
        {
          "description": "Default `false`",
          "example": true,
          "in": "query",
          "name": "sort_ascending",
          "schema": {
            "default": false,
            "type": "boolean"
          }
        }
      ]
    },
    "/workspaces/{workspace_gid}/teams": {
      "get": {
        "description": "<b>Required scope: </b><code>teams:read</code>\n\nReturns the compact records for all teams in the workspace visible to the authorized user.",
        "operationId": "getTeamsForWorkspace",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "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.default_access_level",
              "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.html_text_value",
              "custom_field_settings.custom_field.id_prefix",
              "custom_field_settings.custom_field.input_restrictions",
              "custom_field_settings.custom_field.is_formula_field",
              "custom_field_settings.custom_field.is_global_to_workspace",
              "custom_field_settings.custom_field.is_lookup_field",
              "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.privacy_setting",
              "custom_field_settings.custom_field.reference_value",
              "custom_field_settings.custom_field.reference_value.name",
              "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.parent.resource_subtype",
              "custom_field_settings.project",
              "custom_field_settings.project.name",
              "custom_field_settings.project.resource_subtype",
              "description",
              "edit_team_name_or_description_access_level",
              "edit_team_visibility_or_trash_team_access_level",
              "endorsed",
              "guest_invite_management_access_level",
              "html_description",
              "join_request_management_access_level",
              "member_invite_management_access_level",
              "name",
              "offset",
              "organization",
              "organization.name",
              "path",
              "permalink_url",
              "team_content_management_access_level",
              "team_member_removal_access_level",
              "uri",
              "visibility"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "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.default_access_level",
                  "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.html_text_value",
                  "custom_field_settings.custom_field.id_prefix",
                  "custom_field_settings.custom_field.input_restrictions",
                  "custom_field_settings.custom_field.is_formula_field",
                  "custom_field_settings.custom_field.is_global_to_workspace",
                  "custom_field_settings.custom_field.is_lookup_field",
                  "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.privacy_setting",
                  "custom_field_settings.custom_field.reference_value",
                  "custom_field_settings.custom_field.reference_value.name",
                  "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.parent.resource_subtype",
                  "custom_field_settings.project",
                  "custom_field_settings.project.name",
                  "custom_field_settings.project.resource_subtype",
                  "description",
                  "edit_team_name_or_description_access_level",
                  "edit_team_visibility_or_trash_team_access_level",
                  "endorsed",
                  "guest_invite_management_access_level",
                  "html_description",
                  "join_request_management_access_level",
                  "member_invite_management_access_level",
                  "name",
                  "offset",
                  "organization",
                  "organization.name",
                  "path",
                  "permalink_url",
                  "team_content_management_access_level",
                  "team_member_removal_access_level",
                  "uri",
                  "visibility"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/TeamCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__TeamResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Returns the team records for all teams in the organization or workspace accessible to the authenticated user."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "teams:read"
            ]
          }
        ],
        "summary": "Get teams in a workspace",
        "tags": [
          "Teams"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}~1teams/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Team> result = client.teams.getTeamsForWorkspace(workspaceGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet teamsApiInstance = new Asana.TeamsApi(client);\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,description,edit_team_name_or_description_access_level,edit_team_visibility_or_trash_team_access_level,endorsed,guest_invite_management_access_level,html_description,join_request_management_access_level,member_invite_management_access_level,name,offset,organization,organization.name,path,permalink_url,team_content_management_access_level,team_member_removal_access_level,uri,visibility\"\n};\nteamsApiInstance.getTeamsForWorkspace(workspace_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.teams.getTeamsForWorkspace(workspaceGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nteams_api_instance = asana.TeamsApi(api_client)\nworkspace_gid = \"12345\" # str | Globally unique identifier for the workspace or organization.\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    'opt_fields': \"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.default_access_level,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.html_text_value,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.input_restrictions,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_lookup_field,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.privacy_setting,custom_field_settings.custom_field.reference_value,custom_field_settings.custom_field.reference_value.name,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.parent.resource_subtype,custom_field_settings.project,custom_field_settings.project.name,custom_field_settings.project.resource_subtype,description,edit_team_name_or_description_access_level,edit_team_visibility_or_trash_team_access_level,endorsed,guest_invite_management_access_level,html_description,join_request_management_access_level,member_invite_management_access_level,name,offset,organization,organization.name,path,permalink_url,team_content_management_access_level,team_member_removal_access_level,uri,visibility\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get teams in a workspace\n    api_response = teams_api_instance.get_teams_for_workspace(workspace_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TeamsApi->get_teams_for_workspace: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.teams.get_teams_for_workspace(workspace_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->teams->getTeamsForWorkspace($workspace_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.teams.get_teams_for_workspace(workspace_gid: 'workspace_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/workspace_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/workspaces/{workspace_gid}/typeahead": {
      "get": {
        "description": "<b>Required scope: </b><code>workspaces.typeahead:read</code>\n\nRetrieves objects in the workspace based via an auto-completion/typeahead\nsearch algorithm. This feature is meant to provide results quickly, so do\nnot rely on this API to provide extremely accurate search results. The\nresult set is limited to a single page of results with a maximum size, so\nyou won’t be able to fetch large numbers of results.\n\nThe typeahead search API provides search for objects from a single\nworkspace. This endpoint should be used to query for objects when\ncreating an auto-completion/typeahead search feature. This API is meant\nto provide results quickly and should not be relied upon for accurate or\nexhaustive search results. The results sets are limited in size and\ncannot be paginated.\n\nQueries return a compact representation of each object which is typically\nthe gid and name fields. Interested in a specific set of fields or all of\nthe fields?! Of course you are. Use field selectors to manipulate what\ndata is included in a response.\n\nResources with type `user` are returned in order of most contacted to\nleast contacted. This is determined by task assignments, adding the user\nto projects, and adding the user as a follower to tasks, messages,\netc.\n\nResources with type `project` are returned in order of recency. This is\ndetermined when the user visits the project, is added to the project, and\ncompletes tasks in the project.\n\nResources with type `task` are returned with priority placed on tasks\nthe user is following, but no guarantee on the order of those tasks.\n\nResources with type `project_template` are returned with priority\nplaced on favorited project templates.\n\nLeaving the `query` string empty or omitted will give you results, still\nfollowing the resource ordering above. This could be used to list users or\nprojects that are relevant for the requesting user's api token.\n\nThe `agent` type returns only agents, currently limited to AI Teammates, which are Asana's first-party agents. The `actor` type returns a combined set of users and agents.",
        "operationId": "typeaheadForWorkspace",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "description": "A generic list of objects, such as those returned by the typeahead search endpoint.",
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/AsanaNamedResource"
                          },
                          "type": "array"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__AsanaNamedResourceArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved objects via a typeahead search algorithm."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "workspaces.typeahead:read"
            ]
          }
        ],
        "summary": "Get objects via typeahead",
        "tags": [
          "Typeahead"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}~1typeahead/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<JsonElement> result = client.typeahead.typeaheadForWorkspace(workspaceGid, count, query, type, resourceType)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet typeaheadApiInstance = new Asana.TypeaheadApi(client);\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\nlet resource_type = \"user\"; // String | The type of values the typeahead should return. You can choose from one of the following: `actor`, `agent`, `custom_field`, `goal`, `project`, `project_template`, `portfolio`, `tag`, `task`, `team`, and `user`. Note that unlike in the names of endpoints, the types listed here are in singular form (e.g. `task`). Using multiple types is not yet supported. The `agent` type returns only agents, currently limited to AI Teammates, which are Asana's first-party agents. The `actor` type returns a combined set of users and agents.\nlet opts = { \n    'type': \"user\", \n    'query': \"Greg\", \n    'count': 20, \n    'opt_fields': \"name\"\n};\ntypeaheadApiInstance.typeaheadForWorkspace(workspace_gid, resource_type, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.typeahead.typeaheadForWorkspace(workspaceGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\ntypeahead_api_instance = asana.TypeaheadApi(api_client)\nworkspace_gid = \"12345\" # str | Globally unique identifier for the workspace or organization.\nresource_type = \"user\" # str | The type of values the typeahead should return. You can choose from one of the following: `actor`, `agent`, `custom_field`, `goal`, `project`, `project_template`, `portfolio`, `tag`, `task`, `team`, and `user`. Note that unlike in the names of endpoints, the types listed here are in singular form (e.g. `task`). Using multiple types is not yet supported. The `agent` type returns only agents, currently limited to AI Teammates, which are Asana's first-party agents. The `actor` type returns a combined set of users and agents.\nopts = {\n    'type': \"user\", # str | *Deprecated: new integrations should prefer the resource_type field.*\n    'query': \"Greg\", # str | The string that will be used to search for relevant objects. If an empty string is passed in, the API will return results.\n    'count': 20, # int | The number of results to return. The default is 20 if this parameter is omitted, with a minimum of 1 and a maximum of 100. If there are fewer results found than requested, all will be returned.\n    'opt_fields': \"name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get objects via typeahead\n    api_response = typeahead_api_instance.typeahead_for_workspace(workspace_gid, resource_type, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling TypeaheadApi->typeahead_for_workspace: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.typeahead.typeahead_for_workspace(workspace_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->typeahead->typeaheadForWorkspace($workspace_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.typeahead.typeahead_for_workspace(workspace_gid: 'workspace_gid', resource_type: '&#x27;resource_type_example&#x27;', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/workspace_path_gid"
        },
        {
          "description": "The type of values the typeahead should return. You can choose from one of the following: `actor`, `agent`, `custom_field`, `goal`, `project`, `project_template`, `portfolio`, `tag`, `task`, `team`, and `user`. Note that unlike in the names of endpoints, the types listed here are in singular form (e.g. `task`). Using multiple types is not yet supported. The `agent` type returns only agents, currently limited to AI Teammates, which are Asana's first-party agents. The `actor` type returns a combined set of users and agents.",
          "in": "query",
          "name": "resource_type",
          "required": true,
          "schema": {
            "default": "user",
            "enum": [
              "actor",
              "agent",
              "custom_field",
              "goal",
              "project",
              "project_template",
              "portfolio",
              "tag",
              "task",
              "team",
              "user"
            ],
            "type": "string"
          }
        },
        {
          "description": "*Deprecated: new integrations should prefer the resource_type field.*",
          "in": "query",
          "name": "type",
          "required": false,
          "schema": {
            "default": "user",
            "enum": [
              "custom_field",
              "portfolio",
              "project",
              "tag",
              "task",
              "user"
            ],
            "type": "string"
          }
        },
        {
          "description": "The string that will be used to search for relevant objects. If an empty string is passed in, the API will return results.",
          "example": "Greg",
          "in": "query",
          "name": "query",
          "schema": {
            "type": "string"
          }
        },
        {
          "description": "The number of results to return. The default is 20 if this parameter is omitted, with a minimum of 1 and a maximum of 100. If there are fewer results found than requested, all will be returned.",
          "example": 20,
          "in": "query",
          "name": "count",
          "schema": {
            "type": "integer"
          }
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ]
    },
    "/workspaces/{workspace_gid}/users": {
      "get": {
        "description": "<b>Required scope: </b><code>users:read</code>\n\nReturns the compact records for all users in the specified workspace or organization.\nResults are sorted alphabetically and limited to 2000. For more results use the `/users` endpoint.",
        "operationId": "getUsersForWorkspace",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "email",
              "name",
              "photo",
              "photo.image_1024x1024",
              "photo.image_128x128",
              "photo.image_21x21",
              "photo.image_27x27",
              "photo.image_36x36",
              "photo.image_60x60",
              "workspaces",
              "workspaces.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "email",
                  "name",
                  "photo",
                  "photo.image_1024x1024",
                  "photo.image_128x128",
                  "photo.image_21x21",
                  "photo.image_27x27",
                  "photo.image_36x36",
                  "photo.image_60x60",
                  "workspaces",
                  "workspaces.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/UserCompact"
                          },
                          "type": "array"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__UserResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Return the users in the specified workspace or org."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "users:read"
            ]
          }
        ],
        "summary": "Get users in a workspace or organization",
        "tags": [
          "Users"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}~1users/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<User> result = client.users.getUsersForWorkspace(workspaceGid)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet usersApiInstance = new Asana.UsersApi(client);\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\nlet opts = { \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,email,name,photo,photo.image_1024x1024,photo.image_128x128,photo.image_21x21,photo.image_27x27,photo.image_36x36,photo.image_60x60,workspaces,workspaces.name\"\n};\nusersApiInstance.getUsersForWorkspace(workspace_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.users.getUsersForWorkspace(workspaceGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nusers_api_instance = asana.UsersApi(api_client)\nworkspace_gid = \"12345\" # str | Globally unique identifier for the workspace or organization.\nopts = {\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    'opt_fields': \"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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,email,name,photo,photo.image_1024x1024,photo.image_128x128,photo.image_21x21,photo.image_27x27,photo.image_36x36,photo.image_60x60,workspaces,workspaces.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get users in a workspace or organization\n    api_response = users_api_instance.get_users_for_workspace(workspace_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling UsersApi->get_users_for_workspace: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.users.get_users_for_workspace(workspace_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->users->getUsersForWorkspace($workspace_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.users.get_users_for_workspace(workspace_gid: 'workspace_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/workspace_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    },
    "/workspaces/{workspace_gid}/users/{user_gid}": {
      "get": {
        "description": "<b>Required scope: </b><code>users:read</code>\n\nReturns the full user record for the single user with the provided ID in the specified workspace or organization.",
        "operationId": "getUserForWorkspace",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "email",
              "name",
              "photo",
              "photo.image_1024x1024",
              "photo.image_128x128",
              "photo.image_21x21",
              "photo.image_27x27",
              "photo.image_36x36",
              "photo.image_60x60",
              "workspaces",
              "workspaces.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "email",
                  "name",
                  "photo",
                  "photo.image_1024x1024",
                  "photo.image_128x128",
                  "photo.image_21x21",
                  "photo.image_27x27",
                  "photo.image_36x36",
                  "photo.image_60x60",
                  "workspaces",
                  "workspaces.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/UserResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__UserResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Returns the user specified."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": [
              "users:read"
            ]
          }
        ],
        "summary": "Get a user in a workspace or organization",
        "tags": [
          "Users"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}~1users~1{user_gid}/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet usersApiInstance = new Asana.UsersApi(client);\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\nlet user_gid = \"me\"; // String | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nlet opts = { \n    'opt_fields': \"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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,email,name,photo,photo.image_1024x1024,photo.image_128x128,photo.image_21x21,photo.image_27x27,photo.image_36x36,photo.image_60x60,workspaces,workspaces.name\"\n};\nusersApiInstance.getUserForWorkspace(workspace_gid, user_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nusers_api_instance = asana.UsersApi(api_client)\nworkspace_gid = \"12345\" # str | Globally unique identifier for the workspace or organization.\nuser_gid = \"me\" # str | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nopts = {\n    'opt_fields': \"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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,email,name,photo,photo.image_1024x1024,photo.image_128x128,photo.image_21x21,photo.image_27x27,photo.image_36x36,photo.image_60x60,workspaces,workspaces.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get a user in a workspace or organization\n    api_response = users_api_instance.get_user_for_workspace(workspace_gid, user_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling UsersApi->get_user_for_workspace: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/workspace_path_gid"
        },
        {
          "$ref": "#/components/parameters/user_path_gid"
        },
        {
          "$ref": "#/components/parameters/pretty"
        }
      ],
      "put": {
        "description": "An existing user can be updated by making a PUT request on the URL for that user in the specified workspace or organization. Only the fields provided in the `data` block will be updated; any unspecified fields will remain unchanged.",
        "operationId": "updateUserForWorkspace",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "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.input_restrictions",
              "custom_fields.is_formula_field",
              "custom_fields.is_lookup_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.text_value",
              "custom_fields.type",
              "email",
              "name",
              "photo",
              "photo.image_1024x1024",
              "photo.image_128x128",
              "photo.image_21x21",
              "photo.image_27x27",
              "photo.image_36x36",
              "photo.image_60x60",
              "workspaces",
              "workspaces.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "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.input_restrictions",
                  "custom_fields.is_formula_field",
                  "custom_fields.is_lookup_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.text_value",
                  "custom_fields.type",
                  "email",
                  "name",
                  "photo",
                  "photo.image_1024x1024",
                  "photo.image_128x128",
                  "photo.image_21x21",
                  "photo.image_27x27",
                  "photo.image_36x36",
                  "photo.image_60x60",
                  "workspaces",
                  "workspaces.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/UserUpdateRequest"
                  }
                },
                "type": "object"
              }
            }
          },
          "description": "The user to update.",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/UserResponse"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__UserResponseData"
                    }
                  ]
                }
              }
            },
            "description": "Successfully updated the specified user."
          },
          "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": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Update a user in a workspace or organization",
        "tags": [
          "Users"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}~1users~1{user_gid}/put",
        "x-readme": {
          "code-samples": [
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet usersApiInstance = new Asana.UsersApi(client);\nlet body = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}}; // Object | The user to update.\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\nlet user_gid = \"me\"; // String | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nlet opts = { \n    'opt_fields': \"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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,email,name,photo,photo.image_1024x1024,photo.image_128x128,photo.image_21x21,photo.image_27x27,photo.image_36x36,photo.image_60x60,workspaces,workspaces.name\"\n};\nusersApiInstance.updateUserForWorkspace(body, workspace_gid, user_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "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\nusers_api_instance = asana.UsersApi(api_client)\nbody = {\"data\": {\"<PARAM_1>\": \"<VALUE_1>\", \"<PARAM_2>\": \"<VALUE_2>\",}} # dict | The user to update.\nworkspace_gid = \"12345\" # str | Globally unique identifier for the workspace or organization.\nuser_gid = \"me\" # str | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nopts = {\n    'opt_fields': \"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.input_restrictions,custom_fields.is_formula_field,custom_fields.is_lookup_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.text_value,custom_fields.type,email,name,photo,photo.image_1024x1024,photo.image_128x128,photo.image_21x21,photo.image_27x27,photo.image_36x36,photo.image_60x60,workspaces,workspaces.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Update a user in a workspace or organization\n    api_response = users_api_instance.update_user_for_workspace(body, workspace_gid, user_gid, opts)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling UsersApi->update_user_for_workspace: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            }
          ]
        }
      }
    },
    "/workspaces/{workspace_gid}/workspace_memberships": {
      "get": {
        "description": "Returns the compact workspace membership records for the workspace.",
        "operationId": "getWorkspaceMembershipsForWorkspace",
        "parameters": [
          {
            "description": "This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).",
            "example": [
              "created_at",
              "is_active",
              "is_admin",
              "is_guest",
              "is_view_only",
              "offset",
              "path",
              "uri",
              "user",
              "user.name",
              "user_task_list",
              "user_task_list.name",
              "user_task_list.owner",
              "user_task_list.workspace",
              "vacation_dates",
              "vacation_dates.end_on",
              "vacation_dates.start_on",
              "workspace",
              "workspace.name"
            ],
            "explode": false,
            "in": "query",
            "name": "opt_fields",
            "required": false,
            "schema": {
              "items": {
                "enum": [
                  "created_at",
                  "is_active",
                  "is_admin",
                  "is_guest",
                  "is_view_only",
                  "offset",
                  "path",
                  "uri",
                  "user",
                  "user.name",
                  "user_task_list",
                  "user_task_list.name",
                  "user_task_list.owner",
                  "user_task_list.workspace",
                  "vacation_dates",
                  "vacation_dates.end_on",
                  "vacation_dates.start_on",
                  "workspace",
                  "workspace.name"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "properties": {
                        "data": {
                          "items": {
                            "$ref": "#/components/schemas/WorkspaceMembershipCompact"
                          },
                          "type": "array"
                        },
                        "next_page": {
                          "$ref": "#/components/schemas/NextPage"
                        }
                      },
                      "type": "object"
                    },
                    {
                      "$ref": "#/components/schemas/sdk__WorkspaceMembershipResponseArray"
                    }
                  ]
                }
              }
            },
            "description": "Successfully retrieved the requested workspace's memberships."
          }
        },
        "security": [
          {
            "personalAccessToken": []
          },
          {
            "oauth2": []
          }
        ],
        "summary": "Get the workspace memberships for a workspace",
        "tags": [
          "Workspace memberships"
        ],
        "x-asana-source-url": "https://raw.githubusercontent.com/Asana/openapi/65bd6e77a6692a62c03fefa6a340dd401795e5bc/defs/asana_oas.yaml#/paths/~1workspaces~1{workspace_gid}~1workspace_memberships/get",
        "x-readme": {
          "code-samples": [
            {
              "code": "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<JsonElement> result = client.workspacememberships.getWorkspaceMembershipsForWorkspace(workspaceGid, user)\n    .option(\"pretty\", true)\n    .execute();",
              "install": "<dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>",
              "language": "java"
            },
            {
              "code": "const Asana = require('asana');\n\nlet client = new Asana.ApiClient();\nclient.authentications.token.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet workspaceMembershipsApiInstance = new Asana.WorkspaceMembershipsApi(client);\nlet workspace_gid = \"12345\"; // String | Globally unique identifier for the workspace or organization.\nlet opts = { \n    'user': \"me\", \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'opt_fields': \"created_at,is_active,is_admin,is_guest,is_view_only,offset,path,uri,user,user.name,user_task_list,user_task_list.name,user_task_list.owner,user_task_list.workspace,vacation_dates,vacation_dates.end_on,vacation_dates.start_on,workspace,workspace.name\"\n};\nworkspaceMembershipsApiInstance.getWorkspaceMembershipsForWorkspace(workspace_gid, 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});",
              "install": "npm install asana",
              "language": "node",
              "name": "node-sdk-v3"
            },
            {
              "code": "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.workspacememberships.getWorkspaceMembershipsForWorkspace(workspaceGid, {param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });",
              "install": "npm install asana@1.0.5",
              "language": "node",
              "name": "node-sdk-v1"
            },
            {
              "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\nworkspace_memberships_api_instance = asana.WorkspaceMembershipsApi(api_client)\nworkspace_gid = \"12345\" # str | Globally unique identifier for the workspace or organization.\nopts = {\n    'user': \"me\", # str | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\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    'opt_fields': \"created_at,is_active,is_admin,is_guest,is_view_only,offset,path,uri,user,user.name,user_task_list,user_task_list.name,user_task_list.owner,user_task_list.workspace,vacation_dates,vacation_dates.end_on,vacation_dates.start_on,workspace,workspace.name\", # list[str] | This endpoint returns a 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. Properties can include nested fields. To learn more, see the [input/output options guide](/docs/inputoutput-options#selecting-nested-fields).\n}\n\ntry:\n    # Get the workspace memberships for a workspace\n    api_response = workspace_memberships_api_instance.get_workspace_memberships_for_workspace(workspace_gid, opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling WorkspaceMembershipsApi->get_workspace_memberships_for_workspace: %s\\n\" % e)",
              "install": "pip install asana",
              "language": "python",
              "name": "python-sdk-v5"
            },
            {
              "code": "import asana\n\nclient = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')\n\nresult = client.workspace_memberships.get_workspace_memberships_for_workspace(workspace_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)",
              "install": "pip install asana==3.2.3",
              "language": "python",
              "name": "python-sdk-v3"
            },
            {
              "code": "<?php\nrequire 'vendor/autoload.php';\n\n$client = Asana\\Client::accessToken('PERSONAL_ACCESS_TOKEN');\n\n$result = $client->workspacememberships->getWorkspaceMembershipsForWorkspace($workspace_gid, array('param' => 'value', 'param' => 'value'), array('opt_pretty' => 'true'))",
              "install": "composer require asana/asana",
              "language": "php"
            },
            {
              "code": "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.workspace_memberships.get_workspace_memberships_for_workspace(workspace_gid: 'workspace_gid', param: \"value\", param: \"value\", options: {pretty: true})",
              "install": "gem install asana",
              "language": "ruby"
            }
          ]
        }
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/workspace_path_gid"
        },
        {
          "$ref": "#/components/parameters/user_query_param"
        },
        {
          "$ref": "#/components/parameters/pretty"
        },
        {
          "$ref": "#/components/parameters/limit"
        },
        {
          "$ref": "#/components/parameters/offset"
        }
      ]
    }
  },
  "security": [
    {
      "personalAccessToken": []
    },
    {
      "oauth2": []
    }
  ],
  "servers": [
    {
      "description": "Main endpoint.",
      "url": "https://app.asana.com/api/1.0"
    }
  ],
  "tags": [
    {
      "description": "An access request object represents a user's request to an item, such as a project or portfolio, that they do not have access to. The request is sent to the owner of the item for approval.",
      "name": "Access requests"
    },
    {
      "description": "An *agent* object represents a software program that can perceive its environment, reason, plan, and take autonomous actions to achieve specific goals. Agents may be built by Asana, provided by apps, or defined by the system.",
      "name": "Agents"
    },
    {
      "description": "The AI Studio usage API provides programmatic, admin-only access to AI Studio usage data — credit consumption per run and current seat allocations — for organizations licensed for AI Studio. It is the programmatic equivalent of the AI Studio usage CSV export, intended for loading into a data warehouse or BI tool.",
      "name": "AI Studio usage API"
    },
    {
      "description": "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 of an allocation object can be a percentage or number of hours.",
      "name": "Allocations"
    },
    {
      "description": "An *attachment* object represents any file attached to a task in Asana, whether it's an uploaded file or one associated via a third-party service such as Dropbox or Google Drive.",
      "name": "Attachments"
    },
    {
      "description": "Asana's audit log is an immutable log of [important events](/docs/audit-log-events#supported-audit-log-events) in your organization's Asana instance.\n\nThe audit log API allows you to monitor and act upon important security and compliance-related changes. Organizations might use this API endpoint to:\n\n* Set up proactive alerting with a Security Information and Event Management (SIEM) tool like [Splunk](https://asana.com/guide/help/api/splunk)\n* Conduct reactive investigations when a security incident takes place\n* Visualize key domain data in aggregate to identify security trends\n\nNote that since the API provides insight into what is happening in an Asana instance, the data is [read-only](/reference/getauditlogevents). That is, there are no \"write\" or \"update\" endpoints for audit log events.\n\nOnly [Service Accounts](https://asana.com/guide/help/premium/service-accounts) in [Enterprise Domains](https://asana.com/enterprise) can access audit log API endpoints. Authentication with a Service Account's [personal access token](/docs/personal-access-token) is required.\n\nFor a full list of supported events, see [supported AuditLogEvents](/docs/audit-log-events#supported-audit-log-events).",
      "name": "Audit log API"
    },
    {
      "description": "There are many cases where you want to accomplish a variety of work in the Asana API but want to minimize the number of HTTP requests you make. For example:\n\n* Modern browsers limit the number of requests that a single web page can\n  make at once.\n* Mobile apps will use more battery life to keep the cellular radio on\n  when making a series of requests.\n* There is an overhead cost to developing software that can make multiple\n  requests in parallel.\n* Some cloud platforms handle parallelism poorly, or disallow it\n  entirely.\n\n\nTo make development easier in these use cases, Asana provides a **batch API** that enables developers to perform multiple “actions” by making only a single HTTP request.\n\n#### Making a batch request\n\nTo make a batch request, send a `POST` request to `/batch`. Like other `POST` endpoints, the body should contain a `data` envelope. Inside this envelope should be a single `actions` field, containing a list of “action” objects.  Each action represents a standard request to an existing endpoint in the Asana API.\n\n**The maximum number of actions allowed in a single batch request is 10**. Making a batch request with no actions in it will result in a `400 Bad Request`.\n\nWhen the batch API receives the list of actions to execute, it will dispatch those actions to the already-implemented endpoints specified by the `relative_path` and `method` for each action. This happens in parallel, so all actions in the request will be processed simultaneously. There is no guarantee of the execution order for these actions, nor is there a way to use the output of one action as the input of another action (such as creating a task and then commenting on it).\n\nThe response to the batch request will contain (within the `data` envelope) a list of result objects, one for each action. The results are guaranteed to be in the same order as the actions in the request (e.g., the first result in the response corresponds to the first action in the request)\n\nThe batch API will always attempt to return a `200 Success` response with individual result objects for each individual action in the request. Only in certain cases (such as missing authorization or malformed JSON in the body) will the entire request fail with another status code. Even if every individual action in the request fails, the batch API will still return a `200 Success` response, and each result object in the response will contain the errors encountered with each action.\n\n#### Rate limiting\n\nThe batch API fully respects all of our rate limiting. This means that a batch request counts against *both* the standard rate limiter and the concurrent request limiter as though you had made a separate HTTP request for every individual action. For example, a batch request with five actions counts as five separate requests in the standard rate limiter, and counts as five concurrent requests in the concurrent request limiter. The batch request itself incurs no cost.\n\nIf any of the actions in a batch request would exceed any of the enforced limits, the *entire* request will fail with a `429 Too Many Requests` error. This is to prevent the unpredictability of which actions might succeed if not all of them could succeed.\n\n#### Restrictions\n\nNot every endpoint can be accessed through the batch API. Specifically, the following actions cannot be taken and will result in a `400 Bad Request` for that action:\n\n* Uploading attachments\n* Creating, getting, or deleting organization exports\n* Any SCIM operations\n* Nested calls to the batch API",
      "name": "Batch API"
    },
    {
      "description": "A *budget* object represents a budget for a specific *parent* resource (such as a project).\n\nEach budget tracks values either in *time* or *cost*, as determined by the *budget_type* field.\n\nWhen *budget_type* is `time`, all values are expressed in minutes. When *budget_type* is `cost`, all values are expressed in the domain’s currency.\n\nA budget can include up to three value objects: *estimate*, *actual*, and *total*. Each contains a `value`, `units`, and may include a `billable_status_filter` field.\n\n**estimate** Represents the aggregated estimated effort on tasks attributed to the *parent*. For time budgets: total estimated minutes. For cost budgets: total estimated cost, computed as (estimated time × resource rate).\n\n**actual** Represents the aggregated actual time logged on tasks attributed to the *parent*. For time budgets: total actual minutes from time tracking entries. For cost budgets: total actual cost, computed as (actual time × resource rate). The optional `billable_status_filter` limits aggregation to `billable`, `non_billable`, or `any` entries.\n\n**total** A user-defined target value for the budget. Stored independently per budget type, so switching between *time* and *cost* preserves each type's value. For time budgets: stored and read as minutes. For cost budgets: stored and read in the domain's currency.",
      "name": "Budgets"
    },
    {
      "description": "Custom fields are attached to a particular project with the custom field settings resource. This resource both represents the many-to-many join of the custom field and project as well as stores information that is relevant to that particular pairing. For instance, the `is_important` property determines some possible application-specific handling of that custom field.",
      "name": "Custom field settings"
    },
    {
      "description": "_Note: Custom fields are a premium feature. Integrations which work with custom fields need to handle an assortment of use cases for free and premium users in context of free and premium organizations. For a detailed examination of which data users will have access in different circumstances, review the section below on access control._\n\nIn the Asana application, tasks, projects, and portfolios can hold user-specified [custom fields](https://asana.com/guide/help/premium/custom-fields) which provide extra information (e.g., a \"priority\" property with an associated value, or a number representing the time required to complete a task). This lets a user define the type of information that each item within a project or portfolio can contain in addition to the built-in fields that Asana provides.\n`display_value` is a read-only field that will always be a string. For apps that use custom fields, this is a great way to safely display/export the value of a custom field, regardless of its type. We suggest apps use this field in order to future-proof for changes to custom fields.\n\n#### Characteristics of custom fields\n\n* There is metadata that defines the custom field. This metadata can be shared across an entire workspace, or be specific to a project or portfolio.\n* Creating a custom field setting on a project or portfolio means each direct child will have the custom field. This is conceptually akin to adding columns in a database or a spreadsheet: every task (row) in the project (table) can contain information for that field, including \"blank\" values (i.e., `null` data). For portfolio custom fields, every project (row) in the portfolio (table) will contain information for the custom field.\n* Custom field settings only go one child deep. This means that a custom field setting on a portfolio will give each project the custom field, but not each task within those projects.\n* Tasks have custom field _values_ assigned to them.\n\n#### Types of custom fields\n\nIntegrations using custom fields need to be aware of the seven basic types that a custom field can adopt. These types are:\n\n* `text` - an arbitrary, relatively short string of text\n* `number` - a number with a defined level of precision\n* `enum` - a selection of a single option from a defined list of options (i.e., mutually exclusive selections)\n* `multi_enum` - a selection of one or more options from a defined list of options (i.e., mutually inclusive selections)\n* `date` - a reference date with an optional time value\n* `people` - a list of active contributors (i.e., where their relationship to the work is defined in the custom field title)\n* `reference` - a reference to another Asana object (task, project, portfolio, goal, etc.)\n#### Example use case\n\nConsider an organization that has defined a custom field for \"Priority\". This field is of `enum` type and can have user-defined values of `Low`, `Medium`, or `High`. This is the field metadata, and it is visible within, and shared across, the entire organization.\n\nA project is then created in the organization, called \"Bugs\", and the \"Priority\" custom field is associated with that project. This will allow all tasks within the \"Bugs\" project to have an associated \"Priority\".\n\nA new task is created within \"Bugs\". This task, then, has a field named \"Priority\" which can take on the custom field value of one of `[null]`, `Low`, `Medium`, and `High`.\n\n#### Custom fields in the API\n\nThese custom fields are accessible via the API through a number of endpoints at the top level (e.g. `/custom_fields` and `/custom_field_settings`) and through requests on workspaces, portfolios, projects, and tasks resources. The API also provides a way to fetch both the metadata and data which define each particular custom field, so that a client application may render proper UI to display or edit the values.\n\nText fields are currently limited to 1024 characters. On tasks, their custom field value will have a `text_value` property to represent this field.\n\nNumber fields can have an arbitrary `precision` associated with them; for example, a precision of `2` would round its value to the second (hundredths) place (e.g., `1.2345` would round to `1.23`). On tasks, the custom field value will have a `number_value` property to represent this field.\n\n#### Enum fields\n\nEnum fields represent a selection from a list of options. On the metadata, they will contain all of the options in an array. Each option has 4 properties:\n\n* `gid` - the GID of this enum option. Note that this is the GID of the individual _option_. The custom field itself has a separate `gid`.\n* `name` - the name of the option (e.g., \"Choice #1\")\n* `enabled` - whether this field is enabled. Disabled fields are not available to choose from when disabled, and are visually hidden in the Asana application, but they remain in the metadata for custom field values which were set to the option before the option was disabled.\n* `color` - a color associated with this choice.\n\nOn the task's custom field value, the enum will have an `enum_value` property which will be the same as one of the choices from the list defined in the custom field metadata.\n\n#### Reference custom fields\n\nA `reference` custom field stores a list of references to other Asana objects.\n\nThe `input_restrictions` field on the custom field definition specifies which object types are allowed as values. Possible values include: `task`, `project`, `portfolio`, and `goal`. `input_restrictions` cannot be an empty array, it must have at least one object type.\n\n#### Querying an organization for its custom fields\n\nFor custom fields shared across the workspace or organization, the workspace [can be queried](/reference/getcustomfieldsforworkspace) for its list of defined custom fields. Like other collection queries, the fields will be returned as a compact record; slightly different from most other compact records is the fact that the compact record for custom fields includes `type` as well as `gid` and `name`.\n\n#### Accessing custom field definitions\n\nThe [custom fields](/reference/getcustomfield) reference describes how the metadata which defines a custom field is accessed. A GET request with a `gid` can be issued on the `/custom_fields` endpoint to fetch the full definition of a single custom field given its `gid` from (for instance) listing all custom fields on a workspace, or getting the `gid` from a custom field settings object or a task.\n\n#### Associating custom fields with a project or portfolio\n\nA mapping between a custom field and a project or portfolio is handled with a [custom field settings](/reference/custom-field-settings) object. This object contains a reference for each of the custom fields and the project or portfolio, as well as additional information about the status of that particular custom field (e.g., `is_important`, which defines whether or not the custom field will appear in the list/grid on the Asana application).\n\n#### Accessing custom field values on tasks or projects\n\nThe [tasks](/reference/gettask) reference has information on how custom fields look on tasks. custom fields will return as an array on the property `custom_fields`, and each entry will contain, side-by-side, the compact representation of the custom field metadata and a `{typename}_value` property that stores the value set for the custom field.\n\nOf particular note is that the top-level `gid` of each entry in the `custom_fields` array is the `gid` of the custom field metadata, as it is the compact representation of this metadata. This can be used to refer to the full metadata by making a request to the `/custom_fields/{custom_fields_id}` endpoint as described above.\n\nCustom fields can be set just as in the Asana-defined fields on a task via `POST` or `PUT` requests. You can see an example in the [update a task](/reference/updatetask) endpoint.\n\nCustom fields on projects follow this same pattern.\n\n#### Warning: Program defensively with regards to custom field definitions\n\nAsana application users have the ability to change the definitions of custom field metadata. This means that as you write scripts or applications to work with them, it is possible for the definitions to change at any time, which may cause an application using them to break or malfunction if it makes assumptions about the metadata for a particular custom field. When using custom fields, it is a good idea to program *defensively*, meaning you your application should double-check that the custom field metadata are what it expects.\n\nStoring the state of the custom field metadata for too long if you dynamically create a model for it can cause your model to become out of sync with the model stored in Asana. For example, if you encounter an `enum` value on a task that does not match any option in your metadata model, your metadata model has become out of date with the custom field metadata.\n\n#### Enabled and disabled values\n\nWhen information that is contained in a custom field value loses a logical association with its metadata definition, the value becomes disabled. This can happen in a couple of simple ways, for example, if you remove the custom field metadata from a project, or move a task with a custom field to a different project which does not have the custom field metadata associated with it. The value remains on the task, and the custom field metadata can still be found and examined, but as the context in which the custom field makes sense is gone, the custom field cannot change its value; it can only be cleared.\n\n_Note: Tasks that are associated with multiple projects do not become disabled, so long as at least one of the projects is still associated with the custom field metadata. In other words, tasks with multiple projects will retain logically associated to the set of custom field metadata represented by all of their projects._\n\nMoving the task back under a project with that custom field applied to it or applying the custom field metadata to the current project will return the custom field value to an enabled state. In this scenario, the custom field will be re-enabled and editable again.\n\nIn the Asana application, disabled fields are grayed out and not allowed to change, other than to be discarded. In the API, we return a property `enabled: false` to inform the external application that the value has been disabled.\n\nNote that the API enforces the same operations on disabled custom field values as hold in the Asana application: they may not have their values changed, since the lack of context for the values of a custom field in general doesn't provide enough information to know what new values should be. Setting the custom field value to `null` will clear and remove the custom field value from the task.\n\n#### Custom field access control\n\nCustom fields are a complex feature of the Asana platform, and their access in the Asana application and in the API vary based on the status of the user and project. When building your application, it is best to be defensive and not assume the given user will have read or write access to a custom field, and fail gracefully when this occurs.",
      "name": "Custom fields"
    },
    {
      "description": "A custom type allows distinct categorizations of objects based on their specific purpose or functionality. Structuring objects through a defined custom type provides greater flexibility in work management allowing users to better match the object to their use case",
      "name": "Custom types"
    },
    {
      "description": "An event is an object representing a change to a resource that was observed by an event subscription. Event streams rely on the same infrastructure as webhooks, which ensures events are delivered within a minute (on average). This system is designed for at most once delivery, meaning in exceptional circumstances a small number of events may be missing from the stream. For this reason, if your use case requires strong guarantees about processing all changes on a resource and cannot tolerate any missing events, regardless of how rare that might be, we recommend building a fallback polling system that fetches the resource periodically as well. Note that while webhooks cannot be replayed once delivered, events are retrievable from the event stream for 24 hours after being processed.\n\nIn general, requesting events on a resource is faster and subject to higher rate limits than requesting the resource itself. Additionally, change events \"bubble up\" (e.g., listening to events on a project would include when stories are added to tasks in the project, and even to subtasks).\n\nEstablish an initial sync token by making a request with no sync token. The response will be a `412 Precondition Failed` error - the same as if the sync token had expired.\n\nSubsequent requests should always provide the sync token from the immediately preceding call.\n\nSync tokens may not be valid if you attempt to go \"backward\" in the history by requesting previous tokens, though re-requesting the current sync token is generally safe, and will always return the same results.\n\nWhen you receive a `412 Precondition Failed` error, it means that the sync token is either invalid or expired. If you are attempting to keep a set of data in sync, this signals you may need to re-crawl the data.\n\nSync tokens always expire after 24 hours, but may expire sooner, depending on load on the service.",
      "name": "Events"
    },
    {
      "description": "Exports are a way to download data from Asana. The following types of exports are available:\n* **Graph exports**: Export of data about objects starting from a parent object, such as a team, portfolio, or project.\n* **Resource exports**: Bulk exports of resources such as tasks, teams, and messages for a workspace.\n* **Organization exports**: Exports the complete data of an organization in JSON format. Please refer to [Organization exports](/reference/organization-exports) for more details.\n\n## Graph exports\nA `graph_export` object represents a request to export the\ndata about objects starting from a parent object. Parent object can be a team, portfolio, or project.\n\nTo create an export using this API:\n1. Create a `graph_export` [request](/reference/createGraphExport) and store the ID that is returned.\n2. Request the [jobs](/reference/getjob) endpoint every few minutes, until `status` field contains 'succeeded'.\n3. Download the file located at the URL in the `download_url` field.\n\nExports can take a long time, from several minutes to a few hours for large portfolios.\n\n*Note: Graph exports are only available to accounts of an\n[Enterprise](https://asana.com/enterprise)/Enterprise+ organization.*\n\n## Resource exports\nA `resource_export` object represents a request to bulk export resources for a workspace.\nTo create an export using this API:\n1. Create a `resource_export` [request](/reference/createResourceExport) and store the job ID that is returned.\n2. Request the [jobs](/reference/getjob) endpoint at some interval, until `status` field contains 'succeeded' and a `download_url` is available.\n3. Download the file located at the URL in the `download_url` field.\n\nExports can take a long time, from several minutes to a few hours for large workspaces.\n\n*Note: Resource exports are only available to [Service Accounts](https://asana.com/guide/help/premium/service-accounts)\nfrom an Enterprise+ organization or an organization with the Compliance Management Add-on.",
      "name": "Exports"
    },
    {
      "description": "A goal relationship is an object representing the relationship between a goal and another goal, a project, a task, or a portfolio.",
      "name": "Goal relationships"
    },
    {
      "description": "A goal is an object in the goal-tracking system that helps your organization drive measurable results.",
      "name": "Goals"
    },
    {
      "description": "Jobs represent processes that handle asynchronous work. A job created when an endpoint requests an action that will be handled asynchronously, such as project or task duplication.\n\nOnly the creator of the duplication process can access the duplication status of the new object.\n\n*Note*: With any work that is handled asynchronously (e.g., [project instantation from a template](/reference/instantiateproject), duplicating a [task](/reference/duplicatetask) or [project](/reference/duplicateproject), etc.), the *intermittent states* of newly-created objects may not be consistent. That is, object properties may return different values each time when polled until the job `status` has returned a `succeeded` value.",
      "name": "Jobs"
    },
    {
      "description": "A membership object represents the relationship between a team or user and an object in Asana. Currently, the\nsupported types of memberships are for goals, projects, custom fields, custom types,and portfolios. For example, a project membership\ncan be used to add a user to a project.",
      "name": "Memberships"
    },
    {
      "description": "Notifications represent activity delivered to a user's Inbox.",
      "name": "Notifications"
    },
    {
      "description": "An OOO entry represents a period of time during which a user is out of office.",
      "name": "Ooo entries"
    },
    {
      "description": "An `organization_export` object represents a request to export the complete data of an organization in JSON format.\n\nTo export an organization using this API:\n\n* Create an `organization_export`\n  [request](/reference/createorganizationexport)\n  and store the ID that is returned.\n* Request the `organization_export` every few minutes, until the\n  `state` field contains ‘finished’.\n* Download the file located at the URL in the `download_url` field. * Exports can take a long time, from several minutes to a few hours\n  for large organizations.\n\n\n*Note: These endpoints are only available to [Service Accounts](https://asana.com/guide/help/premium/service-accounts) of an [Enterprise](https://asana.com/enterprise) organization.*",
      "name": "Organization exports"
    },
    {
      "description": "This object determines if a user is a member of a portfolio.",
      "name": "Portfolio memberships"
    },
    {
      "description": "A portfolio gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent [status update](/reference/status-updates).\nPortfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a maximum of 20 custom fields.",
      "name": "Portfolios"
    },
    {
      "description": "A project brief object represents a rich text document that describes a project.\n\nPlease note that this API is in *preview*, and is expected to change. This API is to be used for development and testing only as an advance view into the upcoming rich text format experience in the task description. For more information, see [this post](https://forum.asana.com/t/project-brief-api-now-available-as-a-preview/150885) in the developer forum.",
      "name": "Project briefs"
    },
    {
      "description": "With the introduction of “comment-only” projects in Asana, a user’s membership in a project comes with associated permissions. These permissions (i.e., whether a user has full access to the project or comment-only access) are accessible through the project memberships endpoints described here.",
      "name": "Project memberships"
    },
    {
      "description": "A project portfolio setting represents the relationship between a project and a portfolio. It controls configuration such as whether portfolio members inherit access to the project.",
      "name": "Project portfolio settings"
    },
    {
      "description": "*Deprecated: new integrations should prefer using [status updates](/reference/status-updates)*\n\nA project status is an update on the progress of a particular project,\nand is sent out to all project followers when created. These updates\ninclude both text describing the update and a color code intended to\nrepresent the overall state of the project: \"green\" for projects that\nare on track, \"yellow\" for projects at risk, \"red\" for projects that\nare behind, and \"blue\" for projects on hold.\n\nProject statuses can be created and deleted, but not modified.",
      "name": "Project statuses"
    },
    {
      "description": "A project template is an object that allows new projects to be created\nwith a predefined setup, which may include tasks, sections, rules, etc.\nIt simplifies the process of running a workflow that involves a similar\nset of work every time.\n\n\nProject templates in organizations are shared with a single team. Currently, the\nteam of a project template cannot be changed via the API.",
      "name": "Project templates"
    },
    {
      "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.\n\nProjects 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.\n\nFollowers 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.\n\n**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)",
      "name": "Projects"
    },
    {
      "description": "A rate object represents the rate of a resource for a parent object.",
      "name": "Rates"
    },
    {
      "description": "A reaction is an object that represents a user's emoji reaction on a status update, comment, task completion, or attachment.",
      "name": "Reactions"
    },
    {
      "description": "A *record* is a single row in a [table](/reference/tables). Fields on a record are backed by the table's custom field settings.",
      "name": "Records"
    },
    {
      "description": "Roles allow workspaces to create and manage workspace-level custom user roles, providing centralized control over what users can do in Asana via Role-Based Access Control (RBAC).\nSuper admins can define roles with specific permission sets and assign users to these roles, helping workspaces meet security and compliance requirements and standardizing how users work in Asana.",
      "name": "Roles"
    },
    {
      "description": "[Asana rules](https://help.asana.com/s/article/rules?language=en_US) allow you to automate common patterns\nand workflows in Asana. Rules comprise triggers that will automatically perform actions. For example, you\ncan create a rule to automatically assign a task (action) when a due date is set (trigger).\n\nTo support cross-application workflows, the API supports\n[incoming web requests](https://developers.asana.com/docs/incoming-web-requests) as a generic trigger to\nconnect external applications to Asana through rules. This API allows users to set up workflows outside\nof Asana that can perform operations on data within Asana.",
      "name": "Rules"
    },
    {
      "description": "A section is a subdivision of a project that groups tasks together. It can either be a header above a list of tasks in a list view or a column in a board view of a project.\n\nSections are largely a shared idiom in Asana’s API for both list and board views of a project regardless of the project’s layout.\n\nThe ‘memberships’ property when [getting a task](/reference/gettask) will return the information for the section or the column under ‘section’ in the response.",
      "name": "Sections"
    },
    {
      "description": "SSPM (SaaS Security Posture Management) is a set of APIs which allows centralized inspection and management of a customer's deployed SaaS apps via an SSPM provider.",
      "name": "SSPM"
    },
    {
      "description": "A status update is an update on the progress of a particular object, and is sent out to all followers when created. These updates include both text describing the update and a `status_type` intended to represent the overall state of the object.\nThe valid values for `status_type` depend on the parent of the status update: - Projects: `on_track`, `at_risk`, `off_track`, `on_hold`, `complete`, `dropped`. - Portfolios: `on_track`, `at_risk`, `off_track`, `on_hold`, `complete`, `dropped`. - Goals: `on_track`, `at_risk`, `off_track`, `achieved`, `partial`, `missed`, `dropped`.\nStatus updates can be created and deleted, but not modified.",
      "name": "Status updates"
    },
    {
      "description": "*See [our forum post](https://forum.asana.com/t/no-more-parsing-story-text-new-fields-on-stories/42924) for more info on when conditional fields are returned.*\n\nA story represents an activity associated with an object in the Asana system. Stories are generated by the system whenever users take actions such as creating or assigning tasks, or moving tasks between projects. \"Comments\" are also a form of user-generated story.",
      "name": "Stories"
    },
    {
      "description": "A *table* is a container for structured [records](/reference/records) (rows), with columns defined by custom field settings.",
      "name": "Tables"
    },
    {
      "description": "A tag is a label that can be attached to any task in Asana. It exists in a single workspace or organization.\n\nTags have some metadata associated with them, but it is possible that we will simplify them in the future so it is not encouraged to rely too heavily on it. Unlike projects, tags do not provide any ordering on the tasks they are associated with.",
      "name": "Tags"
    },
    {
      "description": "A task template is an object that allows new tasks to be created with a predefined setup, which may include followers, dependencies, custom fields, etc. It simplifies the process of running a workflow that involves a similar set of work every time.\nTask templates are contained within a single project.",
      "name": "Task templates"
    },
    {
      "description": "The task is the basic object around which many operations in Asana are centered. In the Asana application, multiple tasks populate the middle pane according to some view parameters, and the set of selected tasks determines the more detailed information presented in the details pane.\n\nSections are unique in that they will be included in the `memberships` field of task objects returned in the API when the task is within a section. They can also be used to manipulate the ordering of a task within a project.\n\n[Queries](/reference/gettasks) return a [compact representation of each task object](/reference/tasks). To retrieve *all* fields or *specific set* of the fields, use [field selectors](/docs/inputoutput-options) to manipulate what data is included in a response.",
      "name": "Tasks"
    },
    {
      "description": "This object determines if a user is a member of a team.",
      "name": "Team memberships"
    },
    {
      "description": "A team is used to group related projects and people together within an organization. Each project in an organization is associated with a team.",
      "name": "Teams"
    },
    {
      "description": "A time period is an object that represents a domain-scoped date range that can be set on [goals](/reference/goals).",
      "name": "Time periods"
    },
    {
      "description": "A time tracking category is a label that can be assigned to time tracking entries to classify logged time. Categories are workspace-scoped and managed by admin users, allowing for more granular reporting and filtering of time entries (e.g., 'Development', 'Meetings').",
      "name": "Time tracking categories"
    },
    {
      "description": "Asana's native time tracking feature allows you to estimate the time needed to complete a task, as well as record the actual time spent.",
      "name": "Time tracking entries"
    },
    {
      "description": "A timesheet approval status represents the approval state for a user's timesheet for a date range. It tracks whether the timesheet is in draft, submitted, approved, or rejected status.",
      "name": "Timesheet approval statuses"
    },
    {
      "description": "The typeahead search API provides search for objects from a single workspace.",
      "name": "Typeahead"
    },
    {
      "description": "A user task list represents the tasks assigned to a particular user. This list is the user's [My Tasks](https://asana.com/guide/help/fundamentals/my-tasks) list.",
      "name": "User task lists"
    },
    {
      "description": "A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.\n\nLike other objects in the system, users are referred to by numerical IDs. However, the special string identifier `me` can be used anywhere a user ID is accepted, to refer to the current authenticated user (e.g, `GET /users/me`).",
      "name": "Users"
    },
    {
      "description": "Webhooks allow you to subscribe to notifications about events that occur on Asana resources (e.g., tasks, projects, stories, etc.).\n\nFor a more detailed explanation of webhooks see the [overview of webhooks](/docs/webhooks-guide).",
      "name": "Webhooks"
    },
    {
      "description": "This object determines if a user is a member of a workspace.",
      "name": "Workspace memberships"
    },
    {
      "description": "A *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.\n\nAn *organization* is a special kind of workspace that represents a company. In an organization, you can group your projects into teams. You can read more about how organizations work on the Asana Guide. To tell if your workspace is an organization or not, check its `is_organization` property.\n\nOver time, we intend to migrate most workspaces into organizations and to release more organization-specific functionality. We may eventually deprecate using workspace-based APIs for organizations. Currently, and until after some reasonable grace period following any further announcements, you can still reference organizations in any `workspace` parameter.",
      "name": "Workspaces"
    }
  ],
  "x-readme": {
    "proxy-enabled": false
  }
}
