Custom Fields

You can create account-specific custom fields for tasks, projects, and users in your Rocketlane account to provide additional information, such as a "priority" field with a range of priority level choices.

In addition to the default field types Rocketlane offers, you can select the field type for the custom fields you create. Once custom fields are created, you cannot change the field type. You have the option to always remove an old custom field and replace it with a new one with the changed field type.

Custom field types available in Rocketlane

Examples of Response for the Get all fields API

• Example of response body for a search request returning a YES_OR_NO field type:

{
    "fieldId":11,
    "fieldLabel":"Billable",
    "objectType":"TASK"
}

• Example of response body for a search request returning a SINGLE_CHOICE field type:

{
    "fieldId":12,
    "fieldLabel":"Priority",
    "objectType":"TASK",
    "fieldOptions":[
        {
            "optionValue":1,
            "optionLabel":"Low"
        },
        {
            "optionValue":2,
            "optionLabel":"Medium"
        },
        {
            "optionValue":3,
            "optionLabel":"High"
        }
    ]
}

Examples of Requests and Responses for Assigning Custom Field Values

Example of Text field type request and response body for updating a resource

Request:

{
    "fields":[
        {
            "fieldId":12,
            "fieldValue":"Rocketlane Onboarding Project"
        }
    ]
}

Response:

{
    "fieldId":215,
    "fieldLabel":"Project alias Name",
    "fieldValue":"Rocketlane APIs"
}

Example of Multiline Text field type request and response body for updating a resource

Request:

{
    "fields":[
        {
            "fieldId":13,
            "fieldValue":"This is a long content.\n It can be split in to multiple lines as well"
        }
    ]
}

Response:

{
    "fieldId":216,
    "fieldLabel":"Project Notes",
    "fieldValue":"MultiLine text line 1\nMultiLine text line 2"
}

Example of Number field type request and response body for updating a resource

Request:

{
    "fields":[
        {
            "fieldId":14,
            "fieldValue":10000.0
        }
    ]
}

Response:

{
    "fieldId":217,
    "fieldLabel":"Setup Fee",
    "fieldValue":10000.0
}

Example of Yes/No field type request and response body for updating a resource

Request:

{
    "fields":[
        {
            "fieldId":15,
            "fieldValue":true
        }
    ]
}

Response:

{
    "fieldId":218,
    "fieldLabel":"Enterprise Customer",
    "fieldValue":true
}

Example of Date field type request and response body for updating a resource

Request:

{
    "fields":[
        {
            "fieldId":16,
            "fieldValue":"2023-07-19"
        }
    ]
}

Response:

{
    "fieldId":219,
    "fieldLabel":"Launch Date",
    "fieldValue":"2023-07-19"
}

Example of Single Choice field type request and response body for updating a resource

For single choice field, optionValue refers the unique identifier for each option and optionLabel refers to the name of each option added for that custom field.

Let us consider an example of a single choice field Priority and the options for the field are Low, Medium and High. The table below shows the mapping between the optionLabel and its corresponding optionValue

Request:

{
    "fields":[
        {
            "fieldId":17,
            "fieldValue":1
        }
    ]
}

Response:

{
    "fieldId":17,
    "fieldLabel":"Priority",
    "fieldValue":1
}

Example of Multiple Choice field type request and response body for updating a resource

For multiple choice field, optionValue refers the unique identifier for each option and optionLabel refers to the name of each option added for that custom field.

Let us consider an example of a multiple choice field Region and the options for the field are USA, UK, Canada and India. The table below shows the mapping between the optionLabel and its corresponding optionValue

Request:

{
    "fields":[
        {
            "fieldId":18,
            "fieldValue":[
                1,
                4
            ]
        }
    ]
}

Response:

{
    "fieldId":221,
    "fieldLabel":"Region",
    "fieldValue":[
        1,
        2
    ]
}

Example of Single user field type request and response body for updating a resource

For single user fields, fieldValue is userId of the user you want to assign to that particular field.

Request:

{
    "fields":[
        {
            "fieldId":19,
            "fieldValue":300
        }
    ]
}

Response:

{
    "fieldId":19,
    "fieldLabel":"CSM",
    "fieldValue":300
}

Example of Multi user field type request and response body for updating a resource

For multi user fields, fieldValue is an array of the userIds you want to assign to that particular field

Request:

{
    "fields":[
        {
            "fieldId":20,
            "fieldValue":[
                323,
                355
            ]
        }
    ]
}

Response:

{
    "fieldId":223,
    "fieldLabel":"Support Team",
    "fieldValue":[
        323,
        355
    ]
}