Skip to content

List an asset field's change history

GET
/assets/{id}/fields/{field_id}/history

Returns the recorded changes to one field’s value on one asset, newest first: the old and new value, when the change was made, by whom and its set_by. Any signed-in user can call this. It doesn’t check the field’s read_capability, whether you may see the asset, or whether the asset or field exists; an unknown id returns an empty list.

limit is clamped to 1-500 and defaults to 50. There is no paging, and entries recorded at the same time have no fixed order. Entries come from the value routes and from other writers such as batch edits, metadata extraction, upload defaults and vocabulary merges, though an upload default’s entry is written on a best-effort basis. Fields that mirror an asset column have no history. Entries are deleted with the asset or field when either is removed for good.

id
required
string format: uuid

The asset’s id.

field_id
required
string format: uuid

The field definition’s id.

limit
integer
default: 50 >= 1 <= 500

Maximum number of entries to return, from 1 to 500. Values outside that range are clamped.

Recorded changes, newest first.

Array<object>
object
id
required

The history entry’s id.

string format: uuid
asset_id
required

The asset’s id.

string format: uuid
field_id
required

The field definition’s id.

string format: uuid
old_value

The value before the change, as an object holding the field’s type and the value. Left out for a first write.

object
key
additional properties
any
new_value

The value after the change, in the same form. Left out when the value was removed.

object
key
additional properties
any
changed_at
required

When the change was recorded.

string format: date-time
changed_by_user_ref

The account that made the change, if known.

integer format: int64
nullable
set_by
required

The set_by of the write that made the change; manual for a removal through this API and computed for a vocabulary merge.

string

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"
}

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed