# proposeFieldDefinition (/api/reference/mutations/propose-field-definition)

Ask for a field, as the AI does when it wants one. The field is `PROPOSED` and takes no values until a workspace admin activates it. A key the workspace already has on that kind of record is refused (`FIELD_KEY_IN_USE`), so a repeat is refused.

```graphql
proposeFieldDefinition(
  input: ProposeFieldDefinitionInput!
): ProposeFieldDefinitionPayload!
```

### Arguments [#arguments]

#### [`proposeFieldDefinition.input`](#input) · [`ProposeFieldDefinitionInput!`](/api/reference/inputs/propose-field-definition-input) `non-null` `input` [#input]
The field to ask for.

### Type [#type]

#### [`ProposeFieldDefinitionPayload`](/api/reference/objects/propose-field-definition-payload) `object` [#proposefielddefinitionpayload-object]
The field that was asked for.