Custom fields
Reorder a custom field's enum
<b>Required scope: </b><code>custom_fields:write</code>
Moves a particular enum option to be either before or after another specified enum option in the custom field. Locked custom fields can only be reordered by the user who locked the field.
post/custom_fields/{custom_field_gid}/enum_options/insert
Request
- Base URL: https://app.asana.com/api/1.0
- URL: https://app.asana.com/api/1.0/custom_fields/{custom_field_gid}/enum_options/insert
- Auth: one of:
- HTTP bearer
- OAuth 2 (authorization code, authorization URL https://app.asana.com/-/oauth_authorize, token URL https://app.asana.com/-/oauth_token, scopes: custom_fields:write)
Query parameters
opt_fieldsstring[]
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. Properties can include nested fields. To learn more, see the input/output options guide.
Request body
Example request
{
"data": {
"enum_option": "97285",
"before_enum_option": "12345",
"after_enum_option": "12345"
}
}Response
Custom field enum option successfully reordered.
Example response
{
"data": {
"gid": "12345",
"resource_type": "enum_option",
"name": "Low",
"enabled": true,
"color": "blue"
}
}Changes
No recorded changes to this operation across all 2 revisions of this API.