# clearFieldValue (/api/reference/mutations/clear-field-value)

Remove a workspace field's value from one record. Clearing a value the record does not have is not an error: `deletedFieldValueId` is then null. The AI (`setBy: AI`) may not clear a value a person set (`FIELD_VALUE_LOCKED`).

```graphql
clearFieldValue(
  input: ClearFieldValueInput!
): ClearFieldValuePayload!
```

### Arguments [#arguments]

#### [`clearFieldValue.input`](#input) · [`ClearFieldValueInput!`](/api/reference/inputs/clear-field-value-input) `non-null` `input` [#input]
The field, and the record to clear it on.

### Type [#type]

#### [`ClearFieldValuePayload`](/api/reference/objects/clear-field-value-payload) `object` [#clearfieldvaluepayload-object]
What was cleared.