Add a custom field to a portfolio

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

Path Params
string
required

Globally unique identifier for the portfolio.

Query Params
boolean

Provides “pretty” output.
Provides 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.

Body Params

Information about the custom field setting.

object
Responses

Response body
object
object

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.

string

Globally unique identifier of the resource, as a string.

string

The base type of this resource.

object

Deprecated: new integrations should prefer the parent field. The id of the project that this custom field settings refers to.

boolean

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.

object

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.

object

The custom field that is applied to the parent.

Language
Credentials
Request
Asana Home
Asana helps you manage projects, focus on what's important, and organize work in one place for seamless collaboration.
© 2023 Asana, Inc.