Developers
Set your API contextPick a region and space ID once. Every sample fills in your base URL.
Where do I find these?

In Coevera: open your space's API application and choose Show Access. It shows the space ID and the base URL, whose host starts with your region.

From the API: if you know the space ID, the discovery endpoint GET /api/discovery/spaces/{space_id} returns its region and base URLs, without credentials.

Only the region and space ID are kept, in this browser. Never paste a key or password here.

More in the quickstart

GraphQLRepositoriesfield

entities.field

Read field records with the field repository, and change them with the field mutations. Same records as the REST Fields entity.

Queries

Fields of entities { field { … } }.

KindFieldReturns
QUERYgetById(entityId: ID!)
Returns the record with the given id, or null when there is none. Deleted records are returned as well.
FieldEntity
QUERYgetByIds(entityIds: [ID!]!)
Returns the records with the given ids; ids without a record are left out. Deleted records are returned as well.
[FieldEntity!]!
QUERYgetAll(limit: Int, offset: Int, filter: FieldFilterInput, orderBy: [FieldOrderByInput!], includeDeleted: Boolean)
Returns the records that match the filter, paged with limit and offset.
[FieldEntity!]!
QUERYgetByCriteria(filter: FieldFilterInput, orderBy: [FieldOrderByInput!], includeDeleted: Boolean, before: String, after: String, first: Int, last: Int)
Returns the records that match the filter as a cursor-paginated connection.
FieldEntityConnection
QUERYgetPublished(limit: Int, offset: Int, filter: FieldFilterInput, orderBy: [FieldOrderByInput!], includeDeleted: Boolean)
Returns the published records that match the filter, paged with limit and offset.
[FieldEntity!]!
QUERYgetDrafts(filter: FieldFilterInput, orderBy: [FieldOrderByInput!])
Returns the records that match the filter, with pending unpublished changes applied where a draft exists.
[FieldEntity!]!
QUERYgetDraftById(entityId: ID!)
Returns the record with the given id, with its pending unpublished changes applied when a draft exists.
FieldEntity!

Mutations

KindMutationDoesReturns
MUTATIONdeleteField(input: DeleteDraftFieldInput!)Soft-deleteDeleteFieldPayload
MUTATIONcreateField(input: CreateDraftFieldInput!)Create one recordCreateFieldPayload
MUTATIONupdateField(input: UpdateDraftFieldInput!)Update fieldsUpdateFieldPayload

Types

The types this repository uses, each with its fields and their descriptions. Types several repositories share, such as PageInfo and the filter fields, are in the types index.

FieldEntity object 51 fields: isDeleteProtected, hasDraft, id, …

Field of an entity, built-in or custom, with its name, type and configuration.

FieldTypeDescription
isDeleteProtectedBoolean!True when the record is protected against deletion because it must always exist in the space. Deleting a record that is not protected can still fail on other checks. Read-only.
hasDraftBooleanTrue when the record has unpublished draft changes, including pending translation changes, that can be published.
idID!Unique identifier of entity.
isDeletedBooleanTrue when the field is marked as deleted (soft-delete).
modifiedDateTimeLast modification time.
createdDateTimeCreation time.
entityNameString!Related entity name for field (e.g. Account, Contact, Lead, Opportunity, ...). Must be a concrete entity: abstract parents such as LeadOppty or Activity are rejected. To share a field between Lead and Opportunity (or Task and Appointment), create it on one of them and set mapDependency to the other.
apiNameStringImmutable and generated name. This name is used for integrations.
nameString!User friendly name for field.
useLangIntWhen true, the field name is treated as a translation key and resolved through the translation system; otherwise the literal name is shown.
columnNameStringStorage column name for the field; used as the filter key in API queries.
columnSourceIntStorage origin of the field: on the main entity record, on the custom-field data record, or computed.
relationIdStringFor relation-typed fields, identifier of the relation kind that connects this entity to the related entity. Empty for non-relation fields.
relationWithEntityIdStringFor relation-typed fields, the entity the field points to (e.g. Contact, Account). Empty for non-relation fields.
sharedWithFieldIdIDWhen the field is shared between abstract entities (e.g. Lead and Opportunity), id of the counterpart field on the other entity. Empty when the field is not shared.
systemTypeIntWhether the field is System (built-in, immutable), Protected (built-in, limited changes), or Custom (user-created).
typeIdString!Type of the field. Supported field types are: checkbox, currency, currency_foreign, date, datetime, dropdown, email, float, input, integer, multiselect_checkbox, phone, radio, sequence, text_area, url
compositeFieldIdIDFor sub-fields of a composite field (e.g. the value/currency parts of a foreign currency field), id of the parent composite field. Empty for top-level fields.
dataSetIdIDOptional custom data set id can be set.
parentOptionsFieldIdIDFor dependent dropdown/radio fields, id of the parent field whose selected value restricts the options shown on this field.
calcFormulaStringCalculated formula used for fields which supports calculation.
defaultValueStringValue pre-filled into this field on newly created records, as text converted to the field type; empty for no default. Accepted only by field types that support a default value.
sequenceSetIdIDFor sequence-typed fields, id grouping the FieldSequence rows that drive auto-numbering for this field.
sequenceIdUUIDDeprecated; always returns null. Use sequenceSetId and FieldSequence instead.
systemRequiredBooleanTrue when the field cannot be made optional (enforced by the platform).
isPublishedBooleanTrue when the field configuration is published; false while the field exists only as an unpublished draft.
systemReadonlyBooleanTrue when the field cannot be made writable (enforced by the platform).
useInGlobalSearchBooleanIf this field is allowed in global search.
settingsJSONStringType-specific configuration for the field (e.g. rollup definition, calculated formula, AI options). Shape depends on type_id; null for fields that need no extra configuration.
isUniqueBooleanIf true, then there will be an API validation if value of entity is unique.
dataSet[FieldDataSetRelation!] (1 args)For dropdown, radio, and multiselect-checkbox fields, the set of available options. Empty for other field types.
lookupLookupPropertyLookup field definition.
sequencePatternStringDeprecated - previously returned sequence pattern used for sequence type of field.
sequenceSequencePropertySequence field definition.
rollupRollupPropertyRollup field definition.
optionsFieldOptionsPropertyType-specific settings of the field, such as the decimal places of a number or the display of a record card; the shape depends on typeId. Empty for types without settings.
aiOptionsFieldAiOptionsAI Smart Field options. Available for input, text_area, integer, float, email, phone, url, currency.
advancedFormulaAdvancedFormulaPropertyFormula of a calculated formula field - the expression, its result type and display - as a JSON object conforming to the AdvancedFormulaProperty type; empty for other field types.
sourceFieldIdString!For derived fields, id of the underlying source field that drives this field's value (e.g. the value side of a composite currency field).
sourceTypeIdString!Underlying primitive type id of the field, after resolving composite/rollup/lookup wrappers.
useInInterfacePreviewBoolean!True when the field can be used in the record interface preview pane.
translatedNameString!Field name resolved into the current user's language. When useLang is true, the name is looked up via the translation system; otherwise name is returned as-is.
fieldPermissions[FieldPermissionEntity!] (1 args)Per-user-role access overrides for this field. Empty when the field uses default access (full access for all roles).
originalDatasetFieldIdUUIDWhen multiple dropdown/radio fields share a data set, id of the field that originally defined the data set. Null when this field is the originator or has no data set.
nameTranslationsJSONString!Map of locale codes to translated field names (e.g. {"en-US": "First name", "de-DE": "Vorname"}). Empty when no translations are defined.
nameTranslatedStringField name in the current user's language, taken from nameTranslations. Empty when no translation is available for that language.
primitiveTypeString!Primitive value type of the field (e.g. STRING, INT, BOOL, DATE, ENUM), derived from sourceTypeId.
isReadonlyOnRecurrentAppointmentBoolean!True when the field cannot be edited on individual occurrences of a recurring appointment (changes must be made on the recurrence master).
isAvailableForWebresourceBoolean!True when the field can be referenced from a Webresource URL template.
isAvailableForAdvancedFormulaBoolean!True when the field can be used as an input in an advanced calculated formula expression on this entity.
instancePermissions[EntityPermsEnum!]! (1 args)Permissions the current user has on this record, out of the requested ones.
FieldEntityConnection object pageInfo: PageInfo!, edges: [FieldEntityEdge]!, totalCount: Int

Paginated list of Field records.

FieldTypeDescription
pageInfoPageInfo!Pagination data for this connection.
edges[FieldEntityEdge]!Contains the nodes in this connection.
totalCountIntTotal number of items in the connection.
FieldEntityEdge object node: FieldEntity, cursor: String!

A Relay edge containing a FieldEntity and its cursor.

FieldTypeDescription
nodeFieldEntityThe item at the end of the edge
cursorString!A cursor for use in pagination
FieldFilterInput input AND, OR, NOT, globalSearchQuery, one condition per field

Filter conditions for Field records. Conditions on different fields are combined with AND; use OR, AND and NOT for other combinations.

Input fieldTypeDescription
OR[FieldFilterInput!]Matches records that meet at least one of the listed filters.
AND[FieldFilterInput!]Matches records that meet all of the listed filters.
NOTFieldFilterInputMatches records that do not meet this filter.
globalSearchQueryStringSearch term matched against the fields that the global search covers for this entity.
idEntityFilterStringFieldUnique identifier of entity.
isDeletedBooleanTrue when the field is marked as deleted (soft-delete).
modifiedEntityFilterDateTimeFieldLast modification time.
createdEntityFilterDateTimeFieldCreation time.
entityNameEntityFilterStringFieldRelated entity name for field (e.g. Account, Contact, Lead, Opportunity, ...). Must be a concrete entity: abstract parents such as LeadOppty or Activity are rejected. To share a field between Lead and Opportunity (or Task and Appointment), create it on one of them and set mapDependency to the other.
apiNameEntityFilterStringFieldImmutable and generated name. This name is used for integrations.
nameEntityFilterStringFieldUser friendly name for field.
useLangEntityFilterNumberFieldWhen true, the field name is treated as a translation key and resolved through the translation system; otherwise the literal name is shown.
columnNameEntityFilterStringFieldStorage column name for the field; used as the filter key in API queries.
columnSourceEntityFilterNumberFieldStorage origin of the field: on the main entity record, on the custom-field data record, or computed.
relationIdEntityFilterStringFieldFor relation-typed fields, identifier of the relation kind that connects this entity to the related entity. Empty for non-relation fields.
relationWithEntityIdEntityFilterStringFieldFor relation-typed fields, the entity the field points to (e.g. Contact, Account). Empty for non-relation fields.
sharedWithFieldIdEntityFilterStringFieldWhen the field is shared between abstract entities (e.g. Lead and Opportunity), id of the counterpart field on the other entity. Empty when the field is not shared.
systemTypeEntityFilterNumberFieldWhether the field is System (built-in, immutable), Protected (built-in, limited changes), or Custom (user-created).
typeIdEntityFilterStringFieldType of the field. Supported field types are: checkbox, currency, currency_foreign, date, datetime, dropdown, email, float, input, integer, multiselect_checkbox, phone, radio, sequence, text_area, url
compositeFieldIdEntityFilterStringFieldFor sub-fields of a composite field (e.g. the value/currency parts of a foreign currency field), id of the parent composite field. Empty for top-level fields.
dataSetIdEntityFilterStringFieldOptional custom data set id can be set.
parentOptionsFieldIdEntityFilterStringFieldFor dependent dropdown/radio fields, id of the parent field whose selected value restricts the options shown on this field.
calcFormulaEntityFilterStringFieldCalculated formula used for fields which supports calculation.
defaultValueEntityFilterStringFieldValue pre-filled into this field on newly created records, as text converted to the field type; empty for no default. Accepted only by field types that support a default value.
sequenceSetIdEntityFilterStringFieldFor sequence-typed fields, id grouping the FieldSequence rows that drive auto-numbering for this field.
systemRequiredBooleanTrue when the field cannot be made optional (enforced by the platform).
isPublishedBooleanTrue when the field configuration is published; false while the field exists only as an unpublished draft.
systemReadonlyBooleanTrue when the field cannot be made writable (enforced by the platform).
useInGlobalSearchBooleanIf this field is allowed in global search.
isUniqueBooleanIf true, then there will be an API validation if value of entity is unique.
sequencePatternEntityFilterStringFieldDeprecated - previously returned sequence pattern used for sequence type of field.
FieldOrderByInput input Asc or Desc per field

Sorting of Field records. Set exactly one field in each item; list several items to sort by more fields, in order of priority.

Input fieldTypeDescription
idOrderByEnumUnique identifier of entity.
isDeletedOrderByEnumTrue when the field is marked as deleted (soft-delete).
modifiedOrderByEnumLast modification time.
createdOrderByEnumCreation time.
entityNameOrderByEnumRelated entity name for field (e.g. Account, Contact, Lead, Opportunity, ...). Must be a concrete entity: abstract parents such as LeadOppty or Activity are rejected. To share a field between Lead and Opportunity (or Task and Appointment), create it on one of them and set mapDependency to the other.
apiNameOrderByEnumImmutable and generated name. This name is used for integrations.
nameOrderByEnumUser friendly name for field.
useLangOrderByEnumWhen true, the field name is treated as a translation key and resolved through the translation system; otherwise the literal name is shown.
columnNameOrderByEnumStorage column name for the field; used as the filter key in API queries.
columnSourceOrderByEnumStorage origin of the field: on the main entity record, on the custom-field data record, or computed.
relationIdOrderByEnumFor relation-typed fields, identifier of the relation kind that connects this entity to the related entity. Empty for non-relation fields.
relationWithEntityIdOrderByEnumFor relation-typed fields, the entity the field points to (e.g. Contact, Account). Empty for non-relation fields.
sharedWithFieldIdOrderByEnumWhen the field is shared between abstract entities (e.g. Lead and Opportunity), id of the counterpart field on the other entity. Empty when the field is not shared.
systemTypeOrderByEnumWhether the field is System (built-in, immutable), Protected (built-in, limited changes), or Custom (user-created).
typeIdOrderByEnumType of the field. Supported field types are: checkbox, currency, currency_foreign, date, datetime, dropdown, email, float, input, integer, multiselect_checkbox, phone, radio, sequence, text_area, url
compositeFieldIdOrderByEnumFor sub-fields of a composite field (e.g. the value/currency parts of a foreign currency field), id of the parent composite field. Empty for top-level fields.
dataSetIdOrderByEnumOptional custom data set id can be set.
parentOptionsFieldIdOrderByEnumFor dependent dropdown/radio fields, id of the parent field whose selected value restricts the options shown on this field.
calcFormulaOrderByEnumCalculated formula used for fields which supports calculation.
defaultValueOrderByEnumValue pre-filled into this field on newly created records, as text converted to the field type; empty for no default. Accepted only by field types that support a default value.
systemRequiredOrderByEnumTrue when the field cannot be made optional (enforced by the platform).
isPublishedOrderByEnumTrue when the field configuration is published; false while the field exists only as an unpublished draft.
systemReadonlyOrderByEnumTrue when the field cannot be made writable (enforced by the platform).
useInGlobalSearchOrderByEnumIf this field is allowed in global search.
isUniqueOrderByEnumIf true, then there will be an API validation if value of entity is unique.
sequencePatternOrderByEnumDeprecated - previously returned sequence pattern used for sequence type of field.
AdvancedFormulaPropertyParams input 5 fields: formula, type, displayOption, …

Definition of an advanced formula field: the formula, the type of its result and how the result is displayed.

Input fieldTypeDescription
formulaString!Expression evaluated to produce the field value, referencing other fields by id.
typeAdvancedFormulaTypeEnum!Result type of the formula — integer, float, currency, string, date, datetime or bool.
displayOptionAdvancedFormulaDisplayOptionEnumHow a numeric result is formatted — Number, Percentage, Days, Months, Years or Custom (uses displayOptionCustomValue as a suffix).
displayOptionCustomValueStringCustom suffix appended to the result when displayOption is Custom.
decimalPlacesIntNumber of decimal places a numeric result is rounded to for display.
CreateDraftFieldInput input 23 fields: clientMutationId, modified, created, …

Parameters of the createField mutation.

Input fieldTypeDescription
clientMutationIdStringOptional client-supplied identifier passed on a mutation input and echoed back unchanged on its payload, so a client can correlate the response with its request (Relay convention).
modifiedDateTimeLast modification time.
createdDateTimeCreation time.
entityNameString!Related entity name for field (e.g. Account, Contact, Lead, Opportunity, ...). Must be a concrete entity: abstract parents such as LeadOppty or Activity are rejected. To share a field between Lead and Opportunity (or Task and Appointment), create it on one of them and set mapDependency to the other.
nameString!User friendly name for field.
typeIdString!Type of the field. Supported field types are: checkbox, currency, currency_foreign, date, datetime, dropdown, email, float, input, integer, multiselect_checkbox, phone, radio, sequence, text_area, url
dataSetIdIDOptional custom data set id can be set.
parentOptionsFieldIdIDFor dependent dropdown/radio fields, id of the parent field whose selected value restricts the options shown on this field.
calcFormulaStringCalculated formula used for fields which supports calculation.
defaultValueStringValue pre-filled into this field on newly created records, as text converted to the field type; empty for no default. Accepted only by field types that support a default value.
useInGlobalSearchBooleanIf this field is allowed in global search.
isUniqueBooleanIf true, then there will be an API validation if value of entity is unique.
dataSet[FieldDataSetItem!]For dropdown, radio, and multiselect-checkbox fields, the set of available options. Empty for other field types.
mapDependencyStringSet at field creation to also create this field on another (related) entity, identified by its entity api name — used to share/map the field across entities. Write-only on create.
lookupLookupPropertyParamsLookup field definition.
sequencePatternStringDeprecated - previously returned sequence pattern used for sequence type of field.
sequenceSequencePropertyParamsSequence field definition.
rollupRollupPropertyParamsRollup field definition.
optionsFieldOptionsPropertyJSONStringType-specific settings of the field, such as the decimal places of a number or the display of a record card; the shape depends on type_id. Empty for types without settings.
aiOptionsFieldAiOptionsParamsAI Smart Field options. Available for input, text_area, integer, float, email, phone, url, currency.
advancedFormulaAdvancedFormulaPropertyParamsFormula of a calculated formula field - the expression, its result type and display - as a JSON object conforming to the AdvancedFormulaProperty type; empty for other field types.
fieldPermissions[FieldPermissionNoFieldBackrefInput!]Per-user-role access overrides for this field. Empty when the field uses default access (full access for all roles).
nameTranslationsJSONStringMap of locale codes to translated field names (e.g. {"en-US": "First name", "de-DE": "Vorname"}). Empty when no translations are defined.
DeleteDraftFieldInput input clientMutationId: String, id: ID

Parameters of the deleteField mutation.

Input fieldTypeDescription
clientMutationIdStringOptional client-supplied identifier passed on a mutation input and echoed back unchanged on its payload, so a client can correlate the response with its request (Relay convention).
idIDUnique identifier of entity.
FieldAiGeneralOptionsParams input 8 fields: prompt, dataSourcesEnabled, webSearchEnabled, …

What the AI uses to generate the value of an AI Smart Field: the prompt and the enabled data sources.

Input fieldTypeDescription
promptString!Instruction the AI follows to generate the field value; it can contain placeholders for values of the record.
dataSourcesEnabledBoolean!When true, the AI can use the data sources enabled below (web search, record data, related records and documents); when false, it uses none of them.
webSearchEnabledBoolean!When true (and dataSourcesEnabled), the AI can search the web.
recordDataEnabledBoolean!When true (and dataSourcesEnabled), the AI receives the field values of the record.
relatedRecordsEnabledBoolean!When true (and dataSourcesEnabled), the AI receives the related records listed in relatedRecords.
relatedRecords[FieldAiOptionsRelatedRecordParams!]!Kinds of related records the AI receives, one item per kind.
recordDocumentsEnabledBoolean!When true (and dataSourcesEnabled), the AI receives the documents attached to the record.
recordDocumentsFilterFieldFilterParamsCondition selecting which attached documents the AI receives; all when not set.
FieldAiOptionsParams input isEnabled: Boolean!, general: FieldAiGeneralOptionsParams!, valueUpdate: FieldAiValueUpdateOptionsParams!

AI Smart Field settings of a field: whether AI generates its value, from which data and when.

Input fieldTypeDescription
isEnabledBoolean!When true, the field is an AI Smart Field whose value is generated by AI.
generalFieldAiGeneralOptionsParams!What the AI uses to generate the value: the prompt and the data sources.
valueUpdateFieldAiValueUpdateOptionsParams!When the AI value is generated or updated.
FieldAiOptionsRelatedRecordParams input targetEntity: EntityNameEnum!, targetEntityApiName: String, entityRelationId: ID, filter: FieldFilterParams

Kind of related records the AI receives when it generates the value of an AI Smart Field.

Input fieldTypeDescription
targetEntityEntityNameEnum!Entity of the related records; CustomEntity for a custom entity (see targetEntityApiName).
targetEntityApiNameStringAPI name of the custom entity when targetEntity is CustomEntity; null otherwise.
entityRelationIdIDId of the relation that links the record to these related records: a system entity relation or a lookup field.
filterFieldFilterParamsCondition selecting which related records the AI receives; all when not set.
FieldAiValueUpdateOptionsParams input 6 fields: manualEnabled, autoUpdateOnRecordCreate, autoUpdateOnRecordUpdate, …

When the value of an AI Smart Field is generated or updated.

Input fieldTypeDescription
manualEnabledBoolean!When true, users can request a new AI value for a record manually.
autoUpdateOnRecordCreateBoolean!When true, the AI value is generated when a record is created.
autoUpdateOnRecordUpdateBoolean!When true, the AI value is generated again whenever a record is updated.
autoUpdateScheduledBoolean!When true, the AI values are generated again on the schedule in autoUpdateSchedule.
autoUpdateScheduleFieldAiValueUpdateScheduleParamsSchedule of the periodic update; used when autoUpdateScheduled is true.
autoUpdateScheduledFilterFieldFilterParamsCondition limiting which records the scheduled update processes; all records of the entity when not set. Each generated value consumes AI credits.
FieldAiValueUpdateScheduleParams input date: DateTime, timeOfDay: Int, dayOfWeek: [Int!], dayOfMonth: [Int!]

Schedule of the periodic update of AI Smart Field values.

Input fieldTypeDescription
dateDateTimeDate and time the schedule runs once. Set for a one-time schedule; left empty for recurring schedules that use the time-of-day and day fields instead.
timeOfDayIntTime of day a recurring schedule runs, in minutes after midnight (0 to 1439).
dayOfWeek[Int!]Weekdays a weekly schedule runs on, from 1 (Monday) to 7 (Sunday).
dayOfMonth[Int!]Days of the month a monthly schedule runs on, from 1 to 31.
FieldDataSetItem input 5 fields: id, optionName, optionNameTranslations, …

Option of a dropdown, radio or multiselect field, as set when creating or changing a draft field.

Input fieldTypeDescription
idUUIDId of an existing option to change; leave empty to add a new option.
optionNameString!Label of the option shown to users; translations go in optionNameTranslations.
optionNameTranslationsJSONStringMap of locale codes to translated option names (e.g. {"en-US": "Hot"}).
calcValueFloat!Numeric value of the option, used in calculation formulas.
allowedBy[ID]For dependent fields, the values of the parent field this option is available for.
FieldPermissionNoFieldBackrefInput input masterRightId: UUID!, permissionLevel: AccessLevelFieldEnum!

Access level a user role gets to a draft field, overriding the default access.

Input fieldTypeDescription
masterRightIdUUID!Id of the user role the access override applies to.
permissionLevelAccessLevelFieldEnum!Access the user role gets to the field.
LookupPropertyParams input 7 fields: entityType, tabName, filter, …

Definition of a lookup field: the entity it links to, which records can be selected and the tab that shows the linked records.

Input fieldTypeDescription
entityTypeLookupEntityTypeEnumEntity the lookup field links to; CustomEntity for a custom entity (see entityApiName).
tabNameString!Name of the tab that shows the records linked through this field.
filterFieldFilterParamsCondition limiting which records can be selected in the field.
showRelatedBoolean!When true, the field offers only records related to the record being edited (e.g. the contacts of its account).
entityApiNameStringAPI name of the linked custom entity when entityType is CustomEntity; null otherwise.
oppositeLookupFieldIdUUIDId of the matching lookup field on the linked entity, which shows the same links from the other side. Set by the server; ignored on input.
hasPrimaryRelationBooleanWhen true, one of the linked records can be marked as primary. Cannot be switched back to false once enabled.
RollupPropertyParams input 7 fields: entityRelationId, targetEntity, entityApiName, …

Definition of a rollup field: which related records it aggregates and with which function.

Input fieldTypeDescription
entityRelationIdIDRelation the rollup follows to reach the related records: the name of an entity relation, or the id of the lookup field on the source entity for a custom relation.
targetEntityEntityNameEnum!Entity kind whose related records are aggregated by this rollup.
entityApiNameStringAPI name of the target custom entity, set when targetEntity is a custom entity.
aggregationFunctionRollupFieldAggregationFunctionEnum!How related values are combined — Count, Average, Sum, First, Last, Min or Max.
fieldIdIDId of the field whose values are aggregated; null for Count, and for First and Last when the whole related record is returned.
filterFieldFilterParamsField-condition filter selecting which related records are aggregated.
sortFieldIdIDId of the field the related records are sorted by to pick the First or Last one.
SequenceItemPropertyParams input id: ID, pattern: String!, filter: FieldFilterParams, lastParticle: SequenceParticlePropertyParams

One numbering sequence of a sequence field: its number pattern, the records it numbers and the last number it issued.

Input fieldTypeDescription
idIDId of the sequence; empty for a new sequence.
patternString!Pattern template used to generate auto-numbered values (e.g. "{prefix}{year}-{####}").
filterFieldFilterParamsConditions a record must meet to be numbered by this sequence; empty matches every record.
lastParticleSequenceParticlePropertyParamsLast number issued by the sequence and its period. Read-only.
SequenceParticlePropertyParams input year: Int!, month: Int!, sequenceNumber: Int!

Last number issued by a numbering sequence of a sequence field, with the year and month of its numbering period.

Input fieldTypeDescription
yearInt!Year of the numbering period; 0 when the pattern has no year.
monthInt!Month of the numbering period; 0 when the pattern has no month.
sequenceNumberInt!Last number issued in the period.
SequencePropertyParams input defaultItem: SequenceItemPropertyParams!, items: [SequenceItemPropertyParams!]!

Automatic numbering of a sequence field: a default numbering sequence and conditional ones chosen by record filters.

Input fieldTypeDescription
defaultItemSequenceItemPropertyParams!Sequence used for records that match none of the items.
items[SequenceItemPropertyParams!]!Conditional sequences, checked in order; a record is numbered by the first one whose filter it matches.
UpdateDraftFieldInput input 20 fields: clientMutationId, id, isDeleted, …

Parameters of the updateField mutation.

Input fieldTypeDescription
clientMutationIdStringOptional client-supplied identifier passed on a mutation input and echoed back unchanged on its payload, so a client can correlate the response with its request (Relay convention).
idIDUnique identifier of entity.
isDeletedBooleanTrue when the field is marked as deleted (soft-delete).
modifiedDateTimeLast modification time.
createdDateTimeCreation time.
nameStringUser friendly name for field.
useLangIntWhen true, the field name is treated as a translation key and resolved through the translation system; otherwise the literal name is shown.
parentOptionsFieldIdIDFor dependent dropdown/radio fields, id of the parent field whose selected value restricts the options shown on this field.
calcFormulaStringCalculated formula used for fields which supports calculation.
defaultValueStringValue pre-filled into this field on newly created records, as text converted to the field type; empty for no default. Accepted only by field types that support a default value.
useInGlobalSearchBooleanIf this field is allowed in global search.
dataSet[FieldDataSetItem!]For dropdown, radio, and multiselect-checkbox fields, the set of available options. Empty for other field types.
lookupLookupPropertyParamsLookup field definition.
sequenceSequencePropertyParamsSequence field definition.
rollupRollupPropertyParamsRollup field definition.
optionsFieldOptionsPropertyJSONStringType-specific settings of the field, such as the decimal places of a number or the display of a record card; the shape depends on type_id. Empty for types without settings.
aiOptionsFieldAiOptionsParamsAI Smart Field options. Available for input, text_area, integer, float, email, phone, url, currency.
advancedFormulaAdvancedFormulaPropertyParamsFormula of a calculated formula field - the expression, its result type and display - as a JSON object conforming to the AdvancedFormulaProperty type; empty for other field types.
fieldPermissions[FieldPermissionNoFieldBackrefInput!]Per-user-role access overrides for this field. Empty when the field uses default access (full access for all roles).
nameTranslationsJSONStringMap of locale codes to translated field names (e.g. {"en-US": "First name", "de-DE": "Vorname"}). Empty when no translations are defined.
CreateFieldPayload object field: FieldEntity, clientMutationId: String

Result of the createField mutation.

FieldTypeDescription
fieldFieldEntityThe created record.
clientMutationIdStringOptional client-supplied identifier passed on a mutation input and echoed back unchanged on its payload, so a client can correlate the response with its request (Relay convention).
DeleteFieldPayload object field: FieldEntity, clientMutationId: String

Result of the deleteField mutation.

FieldTypeDescription
fieldFieldEntityThe deleted record.
clientMutationIdStringOptional client-supplied identifier passed on a mutation input and echoed back unchanged on its payload, so a client can correlate the response with its request (Relay convention).
UpdateFieldPayload object field: FieldEntity!, clientMutationId: String

Result of the updateField mutation.

FieldTypeDescription
fieldFieldEntity!The updated record.
clientMutationIdStringOptional client-supplied identifier passed on a mutation input and echoed back unchanged on its payload, so a client can correlate the response with its request (Relay convention).
AccountCardProperty object showArchivedRecords: Boolean!

Settings of the account card of leads, opportunities and quotes, which shows their linked accounts.

FieldTypeDescription
showArchivedRecordsBoolean!If true, archived records are shown when selecting and displaying the linked records in this card.
AdvancedFormulaDisplayOptionEnum enum Number, Percentage, Days, Months, Years, Custom

How a numeric formula result is displayed.

ValueDescription
NumberPlain number.
PercentageShown as a percentage.
DaysShown as a number of days.
MonthsShown as a number of months.
YearsShown as a number of years.
CustomShown with the custom suffix given in displayOptionCustomValue.
AdvancedFormulaProperty object 5 fields: formula, type, displayOption, …

Definition of an advanced formula field: the formula, the type of its result and how the result is displayed.

FieldTypeDescription
formulaString!Expression evaluated to produce the field value, referencing other fields by id.
typeAdvancedFormulaTypeEnum!Result type of the formula — integer, float, currency, string, date, datetime or bool.
displayOptionAdvancedFormulaDisplayOptionEnumHow a numeric result is formatted — Number, Percentage, Days, Months, Years or Custom (uses displayOptionCustomValue as a suffix).
displayOptionCustomValueStringCustom suffix appended to the result when displayOption is Custom.
decimalPlacesIntNumber of decimal places a numeric result is rounded to for display.
AdvancedFormulaTypeEnum enum integer, float, currency, string, date, datetime, bool

Data type of the result of an advanced (calculated) formula.

ValueDescription
integerWhole number.
floatDecimal number.
currencyMonetary amount.
stringText.
dateCalendar date.
datetimeDate with time.
boolTrue or false.
ClosingDateProperty object isRecurrenceEnabled: Boolean!

Settings of the closing date field of opportunities: whether recurrence is enabled.

FieldTypeDescription
isRecurrenceEnabledBoolean!If true, recurrence is enabled for this closing-date field.
ContactAccountCardProperty object showArchivedRecords: Boolean!

Settings of the related accounts card of contacts, which shows the accounts a contact is linked to.

FieldTypeDescription
showArchivedRecordsBoolean!If true, archived records are shown when selecting and displaying the linked records in this card.
ContactCardProperty object showArchivedRecords: Boolean!

Settings of the contact card of leads, opportunities and quotes, which shows their linked contacts.

FieldTypeDescription
showArchivedRecordsBoolean!If true, archived records are shown when selecting and displaying the linked records in this card.
CountryProperty object enableCustomValues: Boolean!

Settings of a country field: whether values outside the country list are accepted.

FieldTypeDescription
enableCustomValuesBoolean!If true, values outside the predefined country list can be entered.
CurrencyForeignProperty object decimalPlaces: Int!

Settings of a foreign currency field: the number of decimal places shown.

FieldTypeDescription
decimalPlacesInt!Number of decimal places the value is rounded to for display.
CurrencyProperty object decimalPlaces: Int!

Settings of a currency field: the number of decimal places shown.

FieldTypeDescription
decimalPlacesInt!Number of decimal places the value is rounded to for display.
DueDateProperty object isRecurrenceEnabled: Boolean!

Settings of the due date field of tasks: whether recurrence is enabled.

FieldTypeDescription
isRecurrenceEnabledBoolean!If true, recurrence is enabled for this due-date field.
FieldAiGeneralOptions object 8 fields: prompt, dataSourcesEnabled, webSearchEnabled, …

What the AI uses to generate the value of an AI Smart Field: the prompt and the enabled data sources.

FieldTypeDescription
promptString!Instruction the AI follows to generate the field value; it can contain placeholders for values of the record.
dataSourcesEnabledBoolean!When true, the AI can use the data sources enabled below (web search, record data, related records and documents); when false, it uses none of them.
webSearchEnabledBoolean!When true (and dataSourcesEnabled), the AI can search the web.
recordDataEnabledBoolean!When true (and dataSourcesEnabled), the AI receives the field values of the record.
relatedRecordsEnabledBoolean!When true (and dataSourcesEnabled), the AI receives the related records listed in relatedRecords.
relatedRecords[FieldAiOptionsRelatedRecord!]!Kinds of related records the AI receives, one item per kind.
recordDocumentsEnabledBoolean!When true (and dataSourcesEnabled), the AI receives the documents attached to the record.
recordDocumentsFilterFieldFilterCondition selecting which attached documents the AI receives; all when not set.
FieldAiOptions object isEnabled: Boolean!, general: FieldAiGeneralOptions!, valueUpdate: FieldAiValueUpdateOptions!

AI Smart Field settings of a field: whether AI generates its value, from which data and when.

FieldTypeDescription
isEnabledBoolean!When true, the field is an AI Smart Field whose value is generated by AI.
generalFieldAiGeneralOptions!What the AI uses to generate the value: the prompt and the data sources.
valueUpdateFieldAiValueUpdateOptions!When the AI value is generated or updated.
FieldAiOptionsRelatedRecord object targetEntity: EntityNameEnum!, targetEntityApiName: String, entityRelationId: ID, filter: FieldFilter

Kind of related records the AI receives when it generates the value of an AI Smart Field.

FieldTypeDescription
targetEntityEntityNameEnum!Entity of the related records; CustomEntity for a custom entity (see targetEntityApiName).
targetEntityApiNameStringAPI name of the custom entity when targetEntity is CustomEntity; null otherwise.
entityRelationIdIDId of the relation that links the record to these related records: a system entity relation or a lookup field.
filterFieldFilterCondition selecting which related records the AI receives; all when not set.
FieldAiValueUpdateOptions object 6 fields: manualEnabled, autoUpdateOnRecordCreate, autoUpdateOnRecordUpdate, …

When the value of an AI Smart Field is generated or updated.

FieldTypeDescription
manualEnabledBoolean!When true, users can request a new AI value for a record manually.
autoUpdateOnRecordCreateBoolean!When true, the AI value is generated when a record is created.
autoUpdateOnRecordUpdateBoolean!When true, the AI value is generated again whenever a record is updated.
autoUpdateScheduledBoolean!When true, the AI values are generated again on the schedule in autoUpdateSchedule.
autoUpdateScheduleFieldAiValueUpdateScheduleSchedule of the periodic update; used when autoUpdateScheduled is true.
autoUpdateScheduledFilterFieldFilterCondition limiting which records the scheduled update processes; all records of the entity when not set. Each generated value consumes AI credits.
FieldAiValueUpdateSchedule object date: DateTime, timeOfDay: Int, dayOfWeek: [Int!], dayOfMonth: [Int!]

Schedule of the periodic update of AI Smart Field values.

FieldTypeDescription
dateDateTimeDate and time the schedule runs once. Set for a one-time schedule; left empty for recurring schedules that use the time-of-day and day fields instead.
timeOfDayIntTime of day a recurring schedule runs, in minutes after midnight (0 to 1439).
dayOfWeek[Int!]Weekdays a weekly schedule runs on, from 1 (Monday) to 7 (Sunday).
dayOfMonth[Int!]Days of the month a monthly schedule runs on, from 1 to 31.
FieldDataSetRelation object entity: DataEntity!, allowedBy: [ID!]

Option of a dropdown, radio or multiselect field, with the parent field values it is available for.

FieldTypeDescription
entityDataEntity!Option of the data set.
allowedBy[ID!]For dependent fields, the values of the parent field this option is available for; null when the field has no parent options field.
FieldOptionsProperty union RollupProperty | TextAreaProperty | CurrencyProperty | CurrencyForeignProperty | ProductPriceProperty | MultiSelectProperty | FloatProperty | IntegerProperty | ClosingDateProperty | DueDateProperty | LookupSettingsProperty | AdvancedFormulaProperty | FileUploadProperty | OnlineFormProductServicesProperty | AccountCardProperty | ContactCardProperty | OpptyCardProperty | ParentAccountCardProperty | ProjectAccountCardProperty | ContactAccountCardProperty | ProjectContactCardProperty | LinkedItemsProperty | GenderProperty | CountryProperty | LastContactedDateProperty

Type-specific settings of a field; which member type is returned depends on the field type.

FileTypeEnum enum Document, Spreadsheet, Presentation, Pdf, Drawing, Image, … (9 values)

Category of files accepted by a file-upload form field.

ValueDescription
DocumentText documents (e.g. .pdf, .doc, .docx, .odt, .txt).
SpreadsheetSpreadsheets (e.g. .xls, .xlsx, .ods, .csv).
PresentationPresentations (e.g. .ppt, .pptx, .odp).
PdfPDF files only.
DrawingDrawings and CAD files (e.g. .odg, .dwg, .dxf).
ImageImages (e.g. .jpg, .png, .gif, .heic, .webp).
AudioAudio files (e.g. .mp3, .m4a, .wav, .flac).
VideoVideo files (e.g. .mp4, .mov, .mkv, .avi, .webm).
CustomExtensions listed in customFileExtensions.
FileUploadProperty object 5 fields: maxFiles, maxFileSize, fileTypes, …

Settings of a file upload field: how many files, how large and of which types can be uploaded.

FieldTypeDescription
maxFilesInt!Maximum number of files that can be uploaded to this field.
maxFileSizeInt!Maximum size per file, in MB.
fileTypes[FileTypeEnum!]!Allowed file-type categories (e.g. image, document); used when file-type restriction is enabled.
customFileExtensions[String!]!Additional allowed file extensions when the Custom file type is selected (e.g. ".dwg").
fileTypesEnabledBoolean!If true, uploads are restricted to the configured file types and custom extensions; otherwise any file type is accepted.
FloatProperty object useThousandSeparator: Boolean!, decimalPlaces: Int!, unit: String

Display settings of a decimal number field: decimal places, thousands separator and unit.

FieldTypeDescription
useThousandSeparatorBoolean!If true, the value is displayed with a thousands separator (e.g. 1,000).
decimalPlacesInt!Number of decimal places the value is rounded to for display.
unitStringUnit label appended to the displayed value, such as "kg".
GenderProperty object showOnForms: Boolean!, showNonBinaryOption: Boolean!

Settings of the gender field of contacts: whether it is offered on online forms and whether it has a non-binary option.

FieldTypeDescription
showOnFormsBoolean!If true, the gender field is shown on online forms.
showNonBinaryOptionBoolean!If true, a non-binary option is offered in addition to the standard gender options.
IntegerProperty object useThousandSeparator: Boolean!, unit: String

Display settings of a whole number field: thousands separator and unit.

FieldTypeDescription
useThousandSeparatorBoolean!If true, the value is displayed with a thousands separator (e.g. 1,000).
unitStringUnit label appended to the displayed value, such as "kg".
LastContactedDateProperty object lastContactedDateDefinitionFieldId: UUID

Settings of the last contacted date field of accounts and contacts: the date field that replaces the calculated value, if any.

FieldTypeDescription
lastContactedDateDefinitionFieldIdUUIDId of the Date / DateTime field whose value replaces the system-calculated Last Contacted Date. When null, the system calculation (the most recent completed call/email task, appointment, sent email or text message) is used.
LinkedItemsProperty object showArchivedRecords: Boolean!

Settings of the linked items field of activities, emails, memos and other records that can be linked to several records.

FieldTypeDescription
showArchivedRecordsBoolean!If true, archived records are shown when selecting and displaying the linked records in this card.
LookupEntityTypeEnum enum Account, Contact, Lead, Opportunity, Task, Appointment, … (12 values)

Entity that a lookup field links to.

ValueDescription
AccountCompany or organization the sales team works with; contacts, leads, opportunities and activities are linked to it.
ContactPerson the sales team works with, usually linked to one or more accounts, leads and opportunities.
LeadPotential sale in its early stage that moves through a lead process until it is qualified into an opportunity or lost.
OpportunityPotential deal with a value and closing date that moves through the steps of a sales pipeline until it is won or lost.
TaskTask (e.g. a to-do or a call) owned by a user, with an optional due date, and linked to records.
AppointmentMeeting or call scheduled in the calendar, with its invited users and contacts, linked to the records it concerns.
ProductProduct or service in the catalog that can be added as a line item to opportunities and quotes.
OpptyProductRelationProduct line of an opportunity.
ClientUsers of the space.
ProjectProject delivered for an account or run internally, with its objectives, activities and progress.
QuotePrice offer for a customer, usually prepared from an opportunity, with product line items; it moves through a quote process.
CustomEntityRecord of a custom entity, a kind of record the space defines (such as Vehicle or Contract) in addition to the built-in entities.
LookupPrimaryRelationResolutionEnum enum FirstAddedIntoLookup, LastAddedIntoLookup, LatestCreatedWithinLookup, OldestCreatedWithinLookup

Rule that picks the primary related record when a lookup links several records.

ValueDescription
FirstAddedIntoLookupThe record added to the lookup first (default).
LastAddedIntoLookupThe record added to the lookup most recently.
LatestCreatedWithinLookupThe most recently created linked record.
OldestCreatedWithinLookupThe oldest linked record.
LookupProperty object 7 fields: entityType, tabName, filter, …

Definition of a lookup field: the entity it links to, which records can be selected and the tab that shows the linked records.

FieldTypeDescription
entityTypeLookupEntityTypeEnumEntity the lookup field links to; CustomEntity for a custom entity (see entityApiName).
tabNameString!Name of the tab that shows the records linked through this field.
filterFieldFilterCondition limiting which records can be selected in the field.
showRelatedBoolean!When true, the field offers only records related to the record being edited (e.g. the contacts of its account).
entityApiNameStringAPI name of the linked custom entity when entityType is CustomEntity; null otherwise.
oppositeLookupFieldIdUUIDId of the matching lookup field on the linked entity, which shows the same links from the other side. Set by the server; ignored on input.
hasPrimaryRelationBooleanWhen true, one of the linked records can be marked as primary. Cannot be switched back to false once enabled.
LookupSettingsProperty object primaryRelationResolution: LookupPrimaryRelationResolutionEnum

Settings of a lookup field, such as which linked record is treated as the primary one.

FieldTypeDescription
primaryRelationResolutionLookupPrimaryRelationResolutionEnumWhen several records are linked through the lookup, determines which one is treated as the primary related record (e.g. the first one added into the lookup).
MultiSelectProperty object advancedVisualization: Boolean!

Display settings of a multiselect field.

FieldTypeDescription
advancedVisualizationBoolean!If true, selected values are rendered with the advanced (chip/tag) visualization instead of a plain comma-separated list.
OnlineFormProductServicesProperty object 8 fields: showTotalAmount, showProductImages, productSelectionLimitEnabled, …

Settings of a products and services field of online forms: which products are offered and how they are shown.

FieldTypeDescription
showTotalAmountBoolean!If true, the combined total amount of the selected products is shown.
showProductImagesBoolean!If true, product images are shown in the product list.
productSelectionLimitEnabledBoolean!If true, the number of products that can be selected is limited (see maxSelectedProducts).
maxSelectedProductsIntMaximum number of products that can be selected when the selection limit is enabled.
fields[ID!]!Ids of the product fields shown for each selectable product.
productListTypeProductListTypeEnum!Whether the selectable products are a fixed static list or a dynamically filtered set.
staticProducts[ID!]Ids of the products offered when the product list type is static.
dynamicProductsFilterFieldFilterFilter selecting which products are offered when the product list type is dynamic.
OpptyCardProperty object showArchivedRecords: Boolean!

Settings of the opportunity card of quotes, which shows their opportunity.

FieldTypeDescription
showArchivedRecordsBoolean!If true, archived records are shown when selecting and displaying the linked records in this card.
ParentAccountCardProperty object showArchivedRecords: Boolean!

Settings of the parent account card of accounts, which shows the parent account in the account hierarchy.

FieldTypeDescription
showArchivedRecordsBoolean!If true, archived records are shown when selecting and displaying the linked records in this card.
ProductListTypeEnum enum Static, Dynamic

How the products offered in an online form are chosen.

ValueDescription
StaticA fixed list of products (staticProducts).
DynamicProducts matching a filter (dynamicProductsFilter).
ProductPriceProperty object decimalPlaces: Int!

Settings of a product price field: the number of decimal places shown.

FieldTypeDescription
decimalPlacesInt!Number of decimal places the value is rounded to for display.
ProjectAccountCardProperty object showArchivedRecords: Boolean!

Settings of the account card of projects, which shows their linked accounts.

FieldTypeDescription
showArchivedRecordsBoolean!If true, archived records are shown when selecting and displaying the linked records in this card.
ProjectContactCardProperty object showArchivedRecords: Boolean!

Settings of the stakeholders card of projects, which shows their linked contacts.

FieldTypeDescription
showArchivedRecordsBoolean!If true, archived records are shown when selecting and displaying the linked records in this card.
RollupFieldAggregationFunctionEnum enum Count, Average, Sum, First, Last, Min, Max

How a rollup field combines the values of the related records it summarizes.

ValueDescription
CountNumber of related records.
AverageAverage of the related values.
SumTotal of the related values.
FirstThe first related record when ordered by sortFieldId; the result links to that record.
LastThe last related record when ordered by sortFieldId; the result links to that record.
MinLowest related value.
MaxHighest related value.
RollupProperty object 7 fields: entityRelationId, targetEntity, entityApiName, …

Definition of a rollup field: which related records it aggregates and with which function.

FieldTypeDescription
entityRelationIdIDRelation the rollup follows to reach the related records: the name of an entity relation, or the id of the lookup field on the source entity for a custom relation.
targetEntityEntityNameEnum!Entity kind whose related records are aggregated by this rollup.
entityApiNameStringAPI name of the target custom entity, set when targetEntity is a custom entity.
aggregationFunctionRollupFieldAggregationFunctionEnum!How related values are combined — Count, Average, Sum, First, Last, Min or Max.
fieldIdIDId of the field whose values are aggregated; null for Count, and for First and Last when the whole related record is returned.
filterFieldFilterField-condition filter selecting which related records are aggregated.
sortFieldIdIDId of the field the related records are sorted by to pick the First or Last one.
SequenceItemProperty object id: ID, pattern: String!, filter: FieldFilter, lastParticle: SequenceParticleProperty

One numbering sequence of a sequence field: its number pattern, the records it numbers and the last number it issued.

FieldTypeDescription
idIDId of the sequence; empty for a new sequence.
patternString!Pattern template used to generate auto-numbered values (e.g. "{prefix}{year}-{####}").
filterFieldFilterConditions a record must meet to be numbered by this sequence; empty matches every record.
lastParticleSequenceParticlePropertyLast number issued by the sequence and its period. Read-only.
SequenceParticleProperty object year: Int!, month: Int!, sequenceNumber: Int!

Last number issued by a numbering sequence of a sequence field, with the year and month of its numbering period.

FieldTypeDescription
yearInt!Year of the numbering period; 0 when the pattern has no year.
monthInt!Month of the numbering period; 0 when the pattern has no month.
sequenceNumberInt!Last number issued in the period.
SequenceProperty object defaultItem: SequenceItemProperty!, items: [SequenceItemProperty!]!

Automatic numbering of a sequence field: a default numbering sequence and conditional ones chosen by record filters.

FieldTypeDescription
defaultItemSequenceItemProperty!Sequence used for records that match none of the items.
items[SequenceItemProperty!]!Conditional sequences, checked in order; a record is numbered by the first one whose filter it matches.
TextAreaProperty object isRichText: Boolean!

Settings of a text area field: whether it holds rich text.

FieldTypeDescription
isRichTextBoolean!Whether field should be displayed in rich text editor