Set or replace a single field value

PUT

/assets/{id}/fields/{field_id}

• Local development behind nginx (port 8088 by default)

Authorizations

• cookieAuth
• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

field_id

required

string format: uuid

Request Body ^required

Pass whichever value_* field matches the target field’s type. The handler validates against field_definition.type and rejects mismatches with 400.

object

value_text

string

nullable

value_num

number

nullable

value_date

string format: date-time

nullable

value_options

Array<string>

nullable

value_ref

string format: uuid

nullable

set_by

string

default: manual

Allowed values: manual exif iptc xmp api import computed

Responses

200

Value set

One field value as seen on an asset.

object

field_id

required

string format: uuid

field_code

required

string

field_label

string

type

required

string

Allowed values: text longtext rich_text number boolean date datetime select multi_select tree reference

value_text

string

nullable

value_num

number

nullable

value_date

string format: date-time

nullable

value_options

Array<string>

nullable

value_ref

string format: uuid

nullable

set_by

required

string

Allowed values: manual exif iptc xmp api import computed

set_at

required

string format: date-time

set_by_user_ref

integer format: int64

nullable

400

Malformed request

object

error

required

Human-readable error summary

string

Example

the request could not be completed

401

Authentication required, missing, or invalid

object

error

required

Human-readable error summary

string

Example

the request could not be completed

Example

{
  "error": "authentication required: sign in and retry with a valid session or API token"
}

403

Authenticated but missing required capabilities

object

error

required

Human-readable error summary

string

Example

the request could not be completed

404

Resource not found

object

error

required

Human-readable error summary

string

Example

the request could not be completed