# ProposeFieldDefinitionInput (/api/reference/inputs/propose-field-definition-input)

A workspace field to ask for.

```graphql
input ProposeFieldDefinitionInput {
  entity: FieldEntity!
  fillMode: FieldFillMode
  instruction: String
  key: String!
  label: String!
  options: [String!]
  type: FieldType
}
```

### Fields [#fields]

#### [`ProposeFieldDefinitionInput.entity`](#entity) · [`FieldEntity!`](/api/reference/enums/field-entity) `non-null` `enum` [#entity]
The kind of record it is on. It never changes.

#### [`ProposeFieldDefinitionInput.fillMode`](#fill-mode) · [`FieldFillMode`](/api/reference/enums/field-fill-mode) `enum` [#fill-mode]
How the AI would fill it.

#### [`ProposeFieldDefinitionInput.instruction`](#instruction) · [`String`](/api/reference/scalars/string) `scalar` [#instruction]
What the AI would read for and write. Required when `fillMode` is given.

#### [`ProposeFieldDefinitionInput.key`](#key) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#key]
Its stable name: a lower case letter, then up to 62 lower case letters, digits or underscores. It never changes.

#### [`ProposeFieldDefinitionInput.label`](#label) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#label]
The name people see, from 1 to 300 characters.

#### [`ProposeFieldDefinitionInput.options`](#options) · [`[String!]`](/api/reference/scalars/string) `list` `scalar` [#options]
The choices of a `SELECT` or `MULTI_SELECT` field. 100 at most. Other types take none.

#### [`ProposeFieldDefinitionInput.type`](#type) · [`FieldType`](/api/reference/enums/field-type) `enum` [#type]
What kind of value it holds. `TEXT` when left out.

### Member Of [#member-of]

[`proposeFieldDefinition`](/api/reference/mutations/propose-field-definition)  `mutation`