# setFieldValue (/api/reference/mutations/set-field-value)

Set a workspace field's value on one record. A record has one value per field: this replaces the one there. The same value again changes nothing, and the time it was set stays. A field that is proposed or archived takes no values (`FIELD_NOT_ACTIVE`), and a value a person set cannot be replaced by a write that says `AI` (`FIELD_VALUE_LOCKED`).

```graphql
setFieldValue(
  input: SetFieldValueInput!
): SetFieldValuePayload!
```

### Arguments [#arguments]

#### [`setFieldValue.input`](#input) · [`SetFieldValueInput!`](/api/reference/inputs/set-field-value-input) `non-null` `input` [#input]
The field, the record and the value.

### Type [#type]

#### [`SetFieldValuePayload`](/api/reference/objects/set-field-value-payload) `object` [#setfieldvaluepayload-object]
The value that was set.