If you pass in a FieldDefRequest object without an "id" this endpoint will add a new one to the account if the name isn't reserved or in use.
If you pass in a FieldDefRequest object with an "id" this endpoint will update an existing one that matches the id.
To add a value or multiple values to a selection list you must pass an array of "definedValues" that contain objects with a "definedValue" property of the value you want to add.
To update a value or multiple values in a selection list you must pass an array of "definedValues" that contain objects with a "valueId" property of the value id to update and a "definedValue" property of the value you want to update it to.
To remove a value or multiple values from a selection list you must pass an array of "definedValues" that contain objects with a "valueId" property of the value id to remove, a "definedValue" property of the value you want to remove, and a "forRemoval" property set to true.
Example: You have a list of "Years" and you want to change "5" to "5-9" and remove values "6" through "9" and add a value of "10+"
[
NOTE: There are a few reserved field names that cannot be used.
"Project ID", "Project Name", "Colour", "Start Date", "End Date", "Roles", "Status", "Active Phase", "Issues", "Allocated People", "Notes", "Group"
Validation
Other: Free text. Max length: 2400
Address: Free text. Max length: 250
Project Number: Free text. Max length: 250
Budget: Currency. Starts with 0 to 15 digits of 0-9 then optionally followed by . with 0 to 2 digits of 0-9
External ID: Free text. Max length: 250
Labor Hours (Salaried): Positive integer. Must be greater than 0 and not exceed 2,147,483,647 (Int32.MaxValue). Decimals are not allowed. This is a system field that requires both Project Forecasting and Standard modules to be enabled.
Labor Hours (Hourly): Positive integer. Must be greater than 0 and not exceed 2,147,483,647 (Int32.MaxValue). Decimals are not allowed. This is a system field that requires both Project Forecasting and Hourly Profile modules to be enabled.
Permissions
Account: Write
Private: Read
Finance: Read
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Bad Request: Example when trying to set system fields to private that aren't allowed to be private:
{
Unauthorized
Forbidden
Conflict - Field definition with name already exists in the account or trying to add or update a field to a system field.
Example when trying to add a field that has the same name as an existing one:
{
Unprocessable Entity - Couldn't remove all defined values from list.
Example when trying to remove a defined value in use from a required list:
{