Add a custom field to a project

POST

/projects/{project_gid}/addCustomFieldSetting

Custom fields are associated with projects by way of custom field settings. This method creates a setting for the project.

Request

Path Params

Body Params application/json

Examples

Responses

🟢200Successfully added the custom field to the project.

application/json

Body

🟠400400

🟠401401

🟠403403

🟠404404

🔴500500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://app.asana.com/api/1.0/projects//addCustomFieldSetting' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": {
        "custom_field": "14916",
        "insert_after": "1331",
        "insert_before": "1331",
        "is_important": true
    }
}'

Response Example

200 - Example 1

{
    "data": {
        "gid": "12345",
        "resource_type": "task",
        "custom_field": {
            "gid": "12345",
            "resource_type": "task",
            "display_value": "blue",
            "enabled": true,
            "enum_options": [
                {
                    "gid": "12345",
                    "resource_type": "task",
                    "color": "blue",
                    "enabled": true,
                    "name": "Low"
                }
            ],
            "name": "Status",
            "number_value": 5.2,
            "resource_subtype": "text",
            "text_value": "Some Value",
            "type": "text",
            "currency_code": "EUR",
            "custom_label": "gold pieces",
            "custom_label_position": "suffix",
            "description": "Development team priority",
            "format": "custom",
            "has_notifications_enabled": true,
            "is_global_to_workspace": true,
            "precision": 2,
            "created_by": {
                "gid": "12345",
                "resource_type": "task",
                "name": "Greg Sanchez"
            },
            "enum_value": {
                "gid": "12345",
                "resource_type": "task",
                "color": "blue",
                "enabled": true,
                "name": "Low"
            },
            "multi_enum_values": [
                {
                    "gid": "12345",
                    "resource_type": "task",
                    "color": "blue",
                    "enabled": true,
                    "name": "Low"
                }
            ]
        },
        "is_important": false,
        "parent": {
            "gid": "12345",
            "resource_type": "task",
            "name": "Stuff to buy"
        },
        "project": {
            "gid": "12345",
            "resource_type": "task",
            "name": "Stuff to buy"
        }
    }
}

Modified at 2022-09-13 02:00:31

Update a project

Add followers to a project