Asana

Asana Enum Options API

The Asana Enum Options API is a tool that allows users to retrieve and manage information about enum options within their Asana projects. Enum options are pre-defined choices that users can select from when filling out specific fields or customizing their project settings. With this API, users can programmatically access and update enum options, making it easier to maintain consistency and accuracy across their projects.

Documentation GitHub OpenAPI

Operations 3

POST /custom_fields/{custom_field_gid}/enum_options Asana Create an enum option #

POST /custom_fields/{custom_field_gid}/enum_options/insert Asana Reorder a custom field's enum #

PUT /enum_options/{enum_option_gid} Asana Update an enum option #

Documentation

📖

Documentation

https://developers.asana.com/reference/createenumoptionforcustomfield

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/asana/refs/heads/main/openapi/asana-enum-options-api-openapi.yml

Work with this as data

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

MCP server

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

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

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

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/asana-enum-options-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

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

Get an API key

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

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: Asana Allocations Enum Options API
  description: The Asana Allocations API allows users to manage and allocate resources within their Asana project management system. An allocation object represents how much of a resource (e.g. person, team) is dedicated to a specific work object (e.g. project, portfolio) over a specific period of time. The effort value can be a percentage or number of hours.
  version: '1.0'
  termsOfService: https://asana.com/terms
  contact:
    name: Asana Support
    url: https://asana.com/support
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
servers:
- url: https://app.asana.com/api/1.0
  description: Main endpoint.
security:
- personalAccessToken: []
- oauth2: []
tags:
- name: Enum Options
  description: Manage enum options for custom fields.
paths:
  /custom_fields/{custom_field_gid}/enum_options:
    post:
      summary: Asana Create an enum option
      description: Creates an enum option and adds it to this custom field's list of enum options.
      operationId: createEnumOptionForCustomField
      tags:
      - Enum Options
      parameters:
      - name: custom_field_gid
        in: path
        required: true
        schema:
          type: string
        example: '12345'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                data:
                  $ref: '#/components/schemas/EnumOptionRequest'
      responses:
        '201':
          description: Successfully created the enum option.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/EnumOption'
        '400':
          description: Bad request.
        '401':
          description: Unauthorized.
        '403':
          description: Forbidden.
        '404':
          description: Not found.
        '500':
          description: Internal server error.
  /custom_fields/{custom_field_gid}/enum_options/insert:
    post:
      summary: Asana Reorder a custom field's enum
      description: Moves a particular enum option to be either before or after another specified enum option.
      operationId: insertEnumOptionForCustomField
      tags:
      - Enum Options
      parameters:
      - name: custom_field_gid
        in: path
        required: true
        schema:
          type: string
        example: '12345'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                data:
                  $ref: '#/components/schemas/EnumOptionInsertRequest'
      responses:
        '200':
          description: Successfully reordered the enum option.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/EnumOption'
        '400':
          description: Bad request.
        '401':
          description: Unauthorized.
        '403':
          description: Forbidden.
        '404':
          description: Not found.
        '500':
          description: Internal server error.
  /enum_options/{enum_option_gid}:
    put:
      summary: Asana Update an enum option
      description: Updates an existing enum option.
      operationId: updateEnumOption
      tags:
      - Enum Options
      parameters:
      - name: enum_option_gid
        in: path
        required: true
        schema:
          type: string
        example: '97514'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                data:
                  $ref: '#/components/schemas/EnumOptionRequest'
      responses:
        '200':
          description: Successfully updated the enum option.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/EnumOption'
        '400':
          description: Bad request.
        '401':
          description: Unauthorized.
        '403':
          description: Forbidden.
        '404':
          description: Not found.
        '500':
          description: Internal server error.
components:
  schemas:
    EnumOptionInsertRequest:
      type: object
      properties:
        enum_option:
          type: string
          description: The gid of the enum option to relocate.
          example: '97285'
        before_enum_option:
          type: string
          description: An existing enum option to insert before.
        after_enum_option:
          type: string
          description: An existing enum option to insert after.
      required:
      - enum_option
    EnumOption:
      type: object
      properties:
        gid:
          type: string
          readOnly: true
          example: '12345'
        resource_type:
          type: string
          readOnly: true
          example: enum_option
        name:
          type: string
          example: Low
        enabled:
          type: boolean
          example: true
        color:
          type: string
          example: blue
    EnumOptionRequest:
      type: object
      properties:
        name:
          type: string
          example: Low
        color:
          type: string
          example: blue
        enabled:
          type: boolean
          example: true
        insert_before:
          type: string
          description: An existing enum option within this custom field before which the new enum option should be inserted.
        insert_after:
          type: string
          description: An existing enum option within this custom field after which the new enum option should be inserted.
  securitySchemes:
    personalAccessToken:
      type: http
      description: A personal access token for the Asana API.
      scheme: bearer
    oauth2:
      type: oauth2
      description: OAuth 2.0 authorization code flow.
      flows:
        authorizationCode:
          authorizationUrl: https://app.asana.com/-/oauth_authorize
          tokenUrl: https://app.asana.com/-/oauth_token
          scopes:
            default: Provides access to all endpoints documented in the API reference.