Sample - Asana API
POST/projects/{project_gid}/removeCustomFieldSetting

Remove a custom field from a project

Removes a custom field setting from a project. Supply the custom_field identifier for the field association to remove. A successful response contains an empty object.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 body field

Information identifying the custom field setting to remove from the project.

dataobjectoptional

6 status codes
200Returns an empty object after the custom field setting is removed from the project.
dataobjectoptional
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.
400Returned when `custom_field` is missing or malformed.
errorsarray<object>optional
401Returned when a valid authentication token is not provided.
errorsarray<object>optional
403Returned when the authenticated user does not have permission to modify the project or access the requested objects.
errorsarray<object>optional
404Returned when the requested action, project, or custom field setting does not exist.
errorsarray<object>optional
500Returned when a server-side problem prevents the custom field setting from being removed.
errorsarray<object>optional

Error handling

A 400 is returned when custom_field is missing or malformed. A 401 is returned when no valid authentication token is provided, and a 403 is returned when the authenticated user lacks permission to modify the project or the required projects:write scope. A 404 indicates that the project or custom field setting does not exist, while a 500 indicates a server-side failure.