Sign in

v1

latestOpenAPI 3.0.12026-07-2464217456.8 KB
Fields

Update field by Id

put/1.0/fields/{fieldId}

Path parameters

fieldIdinteger required

The field's unique, system-generated identifier, which can be used to identify the field globally.

Query parameters

includeFieldsstring[]

This query parameter allows you to specify which field properties should be returned in the response body by selecting from the drop down. To get the relevant field properties, use comma separated values. If this field is left blank, the default properties are returned.

includeAllFieldsboolean
Example:true

This query parameter allows you to specify if all the field properties should be returned in the response body. If the field is left blank, the default field properties are returned.

Request body

fieldLabelstring

The fieldLabel is the name of the field.

fieldDescriptionstring

The description of the field.

enabledboolean

This depicts if the field is enabled or not. Only those fields which are enabled will reflect in the account.

privateboolean

This depicts if the field is private or not.

Example request

{
  "fieldLabel": "Priority",
  "fieldDescription": "Priority of the bug."
}

Response

The requested action was successfully executed.

fieldIdinteger

The field's unique, system-generated identifier, which can be used to identify the field globally.

fieldLabelstring

The fieldLabel is the name of the custom field

fieldDescriptionstring

The description of the field

fieldType'TEXT' | 'MULTI_LINE_TEXT' | 'YES_OR_NO' | 'DATE' | 'SINGLE_CHOICE' | 'MULTIPLE_CHOICE' | 'SINGLE_USER' | 'MULTIPLE_USER' | 'NUMBER' | 'NOTE' | 'RATING'

This defines type of the field. Refer Custom Fields for further information

objectTypestring

This defines type of object that is associated with the field. This could be TASK, PROJECT or USER.

ratingScale'THREE' | 'FIVE' | 'SEVEN' | 'TEN'

The number of stars in the Rating Scale when Field Type is RATING.

createdAtinteger

The time when the field was created. The referenced time will be in epoch millis.

updatedAtinteger

The time when the field was last updated. Any changes that's related to the field are captured and specified here in epoch millis.

enabledboolean

This depicts if the field is enabled or not. Only those fields which are enabled will reflect in the account.

privateboolean

This depicts if the field is private or not.

Example response

{
  "fieldId": 201,
  "fieldLabel": "MRR",
  "fieldDescription": "Priority of the bug.",
  "fieldType": "MULTI_LINE_TEXT",
  "objectType": "TASK",
  "fieldOptions": [
    {
      "optionValue": 2,
      "optionLabel": "Todo",
      "optionColor": "RED"
    }
  ],
  "ratingScale": "THREE",
  "createdBy": {
    "emailId": "john.doe@rocketlane.com",
    "userId": 201,
    "firstName": "John",
    "lastName": "Doe"
  },
  "updatedBy": {
    "emailId": "john.doe@rocketlane.com",
    "userId": 201,
    "firstName": "John",
    "lastName": "Doe"
  },
  "createdAt": 1681319726000,
  "updatedAt": 1681319726000
}