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.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”The asset’s id.
The field definition’s id.
Query Parameters
Section titled “Query Parameters ”Maximum number of entries to return, from 1 to 500. Values outside that range are clamped.
Responses
Section titled “ Responses ”Recorded changes, newest first.
object
The history entry’s id.
The asset’s id.
The field definition’s id.
The value before the change, as an object holding the field’s type and the value. Left out for a first write.
object
The value after the change, in the same form. Left out when the value was removed.
object
When the change was recorded.
The account that made the change, if known.
The set_by of the write that made the change; manual for a removal through this API and computed for a vocabulary merge.
Authentication required, missing, or invalid
object
Human-readable error summary
Example
the request could not be completedExample
{ "error": "authentication required: sign in and retry with a valid session or API token"}Resource not found
object
Human-readable error summary
Example
the request could not be completed