# FieldDefinition (/api/reference/objects/field-definition)

A field the workspace keeps on its people, companies or opportunities, beyond the built-in ones: a company's tool stack, a buyer's sales motion. A field can carry an instruction, and then the AI fills it for each record.

```graphql
type FieldDefinition {
  createdAt: DateTime!
  entity: FieldEntity!
  fillMode: FieldFillMode
  id: ID!
  instruction: String
  key: String!
  label: String!
  options: [String!]!
  status: FieldStatus!
  type: FieldType!
  updatedAt: DateTime!
}
```

### Fields [#fields]

#### [`FieldDefinition.createdAt`](#created-at) · [`DateTime!`](/api/reference/scalars/date-time) `non-null` `scalar` [#created-at]
When it was created.

#### [`FieldDefinition.entity`](#entity) · [`FieldEntity!`](/api/reference/enums/field-entity) `non-null` `enum` [#entity]
The kind of record the field is on. Never changes.

#### [`FieldDefinition.fillMode`](#fill-mode) · [`FieldFillMode`](/api/reference/enums/field-fill-mode) `enum` [#fill-mode]
How the AI may fill it. Null when the AI does not fill it.

#### [`FieldDefinition.id`](#id) · [`ID!`](/api/reference/scalars/id) `non-null` `scalar` [#id]
The field's id.

#### [`FieldDefinition.instruction`](#instruction) · [`String`](/api/reference/scalars/string) `scalar` [#instruction]
What the AI should read for and write, in plain language.

#### [`FieldDefinition.key`](#key) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#key]
The field's stable name: lower case letters, digits and underscores, such as `tool_stack`. Unique per workspace and kind of record, and never changes. A key that is a built-in field's name (`stage`, `reports_to`) carries the AI's instruction for that built-in field and takes no values of its own.

#### [`FieldDefinition.label`](#label) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#label]
The name people see.

#### [`FieldDefinition.options`](#options) · [`[String!]!`](/api/reference/scalars/string) `non-null` `scalar` [#options]
The choices of a `SELECT` or `MULTI_SELECT` field. Empty for other types.

#### [`FieldDefinition.status`](#status) · [`FieldStatus!`](/api/reference/enums/field-status) `non-null` `enum` [#status]
Whether the field is in use.

#### [`FieldDefinition.type`](#type) · [`FieldType!`](/api/reference/enums/field-type) `non-null` `enum` [#type]
What kind of value it holds.

#### [`FieldDefinition.updatedAt`](#updated-at) · [`DateTime!`](/api/reference/scalars/date-time) `non-null` `scalar` [#updated-at]
When it last changed.

### Returned By [#returned-by]

[`fieldDefinition`](/api/reference/queries/field-definition)  `query`

### Member Of [#member-of]

[`ActivateFieldDefinitionPayload`](/api/reference/objects/activate-field-definition-payload)  `object` · [`ArchiveFieldDefinitionPayload`](/api/reference/objects/archive-field-definition-payload)  `object` · [`ChangeSuggestionChange`](/api/reference/objects/change-suggestion-change)  `object` · [`CreateFieldDefinitionPayload`](/api/reference/objects/create-field-definition-payload)  `object` · [`FieldDefinitionEdge`](/api/reference/objects/field-definition-edge)  `object` · [`FieldValue`](/api/reference/objects/field-value)  `object` · [`ProposeFieldDefinitionPayload`](/api/reference/objects/propose-field-definition-payload)  `object` · [`UpdateFieldDefinitionPayload`](/api/reference/objects/update-field-definition-payload)  `object`