Metafield definitions
Update a metafield definition
Changes a metafield definition’s display fields and settings. Send only the fields to change. The namespace, key, value type, owner resource and validation rules cannot be changed: they are ignored when sent, and the request still returns 200. PUT is routed to the same operation.
To turn translations on or off for the field, send "translatable": true or "translatable": false. Turning it off keeps the translations already saved. The setting works only for companies with the translatable metafields feature turned on. For any other company the value is ignored and the request still returns 200 with the stored value, so check translatable in the response.
Requires a company admin credential with the Developer update permission.
PATCH
/
api
/
v2
/
metafield_definitions
/
{id}
curl --request PATCH \
--url https://api.fluid.app/api/v2/metafield_definitions/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"metafield_definition": {
"translatable": true
}
}
'{
"metafield_definition": {
"id": 4812,
"company_id": 1023,
"namespace": "custom",
"key": "tagline",
"name": "Tagline",
"description": "A short line shown under the product title.",
"value_type": "single_line_text_field",
"validation_rules": null,
"owner_resource": "Product",
"pinned": false,
"position": 1,
"locked": false,
"searchable": false,
"translatable": true,
"list_type": false,
"reference_type": false,
"supported_validations": [
"min",
"max",
"choices",
"regex"
],
"validation_description": "Single line text up to 5000 characters",
"category_ids": [],
"created_at": "2026-11-16T16:40:58Z",
"updated_at": "2026-11-16T16:41:20Z"
},
"meta": {
"request_id": "6389a5b2-042b-4ae9-8b51-c0fe906e673d",
"timestamp": "2026-11-16T16:41:20Z"
}
}Body
application/json
⌘I
curl --request PATCH \
--url https://api.fluid.app/api/v2/metafield_definitions/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"metafield_definition": {
"translatable": true
}
}
'{
"metafield_definition": {
"id": 4812,
"company_id": 1023,
"namespace": "custom",
"key": "tagline",
"name": "Tagline",
"description": "A short line shown under the product title.",
"value_type": "single_line_text_field",
"validation_rules": null,
"owner_resource": "Product",
"pinned": false,
"position": 1,
"locked": false,
"searchable": false,
"translatable": true,
"list_type": false,
"reference_type": false,
"supported_validations": [
"min",
"max",
"choices",
"regex"
],
"validation_description": "Single line text up to 5000 characters",
"category_ids": [],
"created_at": "2026-11-16T16:40:58Z",
"updated_at": "2026-11-16T16:41:20Z"
},
"meta": {
"request_id": "6389a5b2-042b-4ae9-8b51-c0fe906e673d",
"timestamp": "2026-11-16T16:41:20Z"
}
}