List a field's team default overrides
GET /fields/{id}/default-overrides
Lists the teams that use their own upload default for this field
instead of the field’s default_value. Requires the fields.admin
or system.admin capability, granted globally.
An override only fills in a value when an asset is created; it never changes values already stored. Overrides of deleted teams are left out. The list is sorted by team name and comes back in one response, with no paging.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”The field definition’s id.
Responses
Section titled “ Responses ”The overrides, sorted by team name. Deleted teams’ overrides are not included.
One team’s override of a field’s upload default.
object
The field definition’s id.
The team’s id.
The team’s slug.
The team’s name.
An upload default: either a fixed value (literal) or a value the
server fills in when the asset is created (context). It is never a
formula.
For a literal, set only the value_* member the field’s type uses;
setting another member is refused with 400. On select,
multi_select and tree fields the slugs must be active terms of
the field. Upload defaults suit values chosen in advance; values
read from the file come from metadata extraction instead.
object
literal for a fixed value, context for one the server fills in when the asset is created.
The literal value for text, longtext, rich_text, select and tree fields. For select and tree, an active slug.
The literal value for number and boolean fields. A boolean is 1 or 0.
The literal value for date and datetime fields.
The literal value for multi_select fields: active slugs.
The literal value for reference fields: an asset id.
Required when kind is context, and not allowed otherwise. The
server fills in the value when the asset is created:
uploading_user: the uploader’s full name from their account, or their username if no full name is set. Use it on text fields.uploading_team: the name of the uploader’s team. Use it on text fields. Skipped when the uploader belongs to no team or to more than one.current_date: the creation time, fordateanddatetimefields. Adatefield gets the day (UTC), adatetimefield the exact time.
These three are the only choices.
When the override was first set. Setting it again keeps this time.
When the override was last set.
The account that last set the override.
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"}Authenticated but missing required capabilities
object
Human-readable error summary
Example
the request could not be completedResource not found
object
Human-readable error summary
Example
the request could not be completed