v1

latestOpenAPI 3.0.12026-08-041753011.2 MB

Custom fields

Update custom field on workspace

put/v1/workspaces/{workspaceId}/custom-fields/{customFieldId}

Path parameters

workspaceIdstring required

Represents a workspace identifier across the system.

Example:64a687e29ae1f428e7ebe303

Represents a workspace identifier across the system.

customFieldIdstring required

Represents a custom field identifier across the system.

Example:26a687e29ae1f428e7ebe101

Represents a custom field identifier across the system.

Request body

allowedValuesstring[]

Represents a list of custom field's allowed values. If field type is not DROPDOWN_SINGLE or DROPDOWN_MULTIPLE, the values provided will be ignored by the server.

descriptionstring

Represents a custom field description.<br/>If this field is not included in the payload,it will automatically be set to null

namestring required

Represents a custom field name.

onlyAdminCanEditboolean

Flag to set whether custom field is modifiable only by admin users.

placeholderstring

Represents a custom field placeholder value.<br/>If this field is not included in the payload,it will automatically be set to null.

requiredboolean

Flag to set whether custom field is mandatory or not.

status'INACTIVE' | 'VISIBLE' | 'INVISIBLE'

Represents a custom field status.<br/>If this field is not included in the payload,it will automatically be set to default INACTIVE.

typestring

Represents a custom field type. This field is now deprecated and it's value will be ignored by the server. It will be removed entirely in a future release. Please stop including it in your payloads. To change a custom field type, please create a new object with the desired type instead.

workspaceDefaultValueobject

Represents a custom field's default value in the workspace.<li>if type = NUMBER, then value must be a number</li><li>if type = DROPDOWN_MULTIPLE, value must be a list</li><li>if type = CHECKBOX, value must be true/false</li><li>otherwise any string</li>

Example request

{
  "allowedValues": [
    "New York",
    "London",
    "Manila",
    "Sydney",
    "Belgrade"
  ],
  "description": "This field contains a location.",
  "name": "location",
  "placeholder": "This is a sample placeholder.",
  "status": "VISIBLE",
  "type": "DROPDOWN_MULTIPLE"
}

Response

allowedValuesstring[]

Represents a list of custom field's allowed values.

descriptionstring

Represents custom field description.

entityTypestring

Represents custom field entity type

idstring

Represents custom field identifier across the system.

namestring

Represents custom field name.

onlyAdminCanEditboolean

Flag to set whether custom field is modifiable only by admin users.

placeholderstring

Represents custom field placeholder value.

requiredboolean

Flag to set whether custom field is mandatory or not.

statusstring

Represents custom field status

typestring

Represents custom field type.

workspaceDefaultValueobject

Represents a custom field's default value in the workspace.

workspaceIdstring

Represents workspace identifier across the system.

Example response

{
  "allowedValues": [
    "New York",
    "London",
    "Manila",
    "Sydney",
    "Belgrade"
  ],
  "description": "This field contains a location.",
  "entityType": "USER",
  "id": "44a687e29ae1f428e7ebe305",
  "name": "location",
  "placeholder": "Location",
  "projectDefaultValues": [
    {
      "projectId": "5b641568b07987035750505e",
      "status": "VISIBLE"
    }
  ],
  "status": "VISIBLE",
  "type": "DROPDOWN_MULTIPLE",
  "workspaceId": "64a687e29ae1f428e7ebe303"
}