v3
latestSwagger 2.02026-08-067506752.0 MBCreate a field
Path parameters
Org identifier (either id or slug)
Query parameters
table type to add the field to
Request body
parent organization id (empty if global)
short field name
human-readable full name of field
description of field
disallow any updates to this Field (except for field.question string)
calculated expression
the expected type of the evaluated expression
type of field
plural type of the field (either SINGLE, LIST, or SET)
default value if field is not set
entity type of field
sensitivity level of data
hide expression-derived values from non-sensitive users
number of days after which the data becomes invalid
the status of the field
the table id this field applies to, only applicable when EntityType equals TABLE
sort order within a table
indicates that this field value is unique in conjunction with entityType PERSON or JOB
indicates that this field value is required
indicates that this field value is effective-dated
set of data fetch types
set of aliases for this field
if this is a group membership field, the group type ID it's for
unique ID for the function that runs to calculate the value of this field. For native fields only
ID of the category to which this field belongs, if any
indicates how this field is calculated (whether it's stored in the DB, evaluated through the expression service, or compound)
number of decimal places for numeric values
whether this field should auto-increment. For unique STRING or INT fields only
Whether the values for ENUM or ENUM_MULTI field can be added automatically by syncs and CSV imports
Example request
{
"orgId": "588f7ee98f138b19220041a7",
"name": "summary",
"label": "Job Summary",
"description": "This field tracks the most recent performance rating for an individual.",
"expr": "(base + variable) / 12",
"values": [
{
"id": "588f7ee98f138b19220041a7"
}
],
"tableId": "588f7ee98f138b19220041a7",
"tableRef": {
"tableId": "588f7ee98f138b19220041a7"
},
"groupTypeId": "588f7ee98f138b19220041a7",
"categoryId": "588f7ee98f138b19220041a7"
}Response
field created
globally unique id
parent organization id (empty if global)
short field name
human-readable full name of field
description of field
disallow any updates to this Field (except for field.question string)
calculated expression
the expected type of the evaluated expression
type of field
plural type of the field (either SINGLE, LIST, or SET)
default value if field is not set
entity type of field
indicates that this field value is unique in conjunction with entityType PERSON or JOB
indicates that this field value is required
indicates that this field value is effective-dated
set of aliases for this field
if this is a group membership field, the group type ID it's for
unique ID for the function that runs to calculate the value of this field. For native fields only
indicates how this field is calculated (whether it's stored in the DB, evaluated through the expression service, or compound)
sensitivity level of data
hide expression-derived values from non-sensitive users
number of days after which the data becomes invalid
the category the field belongs to
the categories the field belongs to
the status of the field
the table id this field applies to, only applicable when EntityType equals TABLE
number of decimal places for money values
whenther this field should auto-increment. For unique STRING or INT fields only
Whether the values for ENUM or ENUM_MULTI field can be added automatically by syncs and CSV imports
created by user id
created timestamp
last updated by user id
last updated timestamp
deleted by user id
deleted timestamp
Example response
{
"id": "588f7ee98f138b19220041a7",
"orgId": "588f7ee98f138b19220041a7",
"name": "summary",
"label": "Job Summary",
"description": "This field tracks the most recent performance rating for an individual.",
"expr": "(base + variable) / 12",
"values": [
{
"id": "588f7ee98f138b19220041a7"
}
],
"groupTypeId": "588f7ee98f138b19220041a7",
"categoryId": "588f7ee98f138b19220041a7",
"categoryIds": [
"588f7ee98f138b19220041a7"
],
"tableId": "588f7ee98f138b19220041a7",
"tableRef": {
"tableId": "588f7ee98f138b19220041a7"
},
"createId": "588f7ee98f138b19220041a7",
"createAt": "2017-01-24T13:57:52Z",
"updateId": "588f7ee98f138b19220041a7",
"updateAt": "2017-01-24T13:57:52Z",
"deleteId": "588f7ee98f138b19220041a7",
"deleteAt": "2017-01-24T13:57:52Z"
}