Set one team's override of a field's upload default (admin)

PUT

/fields/{id}/default-overrides/{team_id}

• Local development behind nginx (port 8088 by default)

Validated exactly as the field’s own default is: against the field’s type, and for a vocabulary field against the live options document, where a deprecated or archived term is rejected. An override that could not apply is never stored.

Authorizations

• cookieAuth
• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

team_id

required

string format: uuid

Request Body ^required

A declarative upload default (ADR 0081 §3). Exactly one of two shapes, discriminated by kind, and never an expression:

• literal — a value in whichever value_* member this field’s type uses (the same mapping AssetFieldValueWrite documents). Populating any other member is a 400: the value would land in a column nothing reads.
• context — a name from a closed set the server resolves at creation time. The operator picks from a menu; nothing they write is evaluated.

For select / multi_select / tree, a literal slug must exist in the field’s options and be active. A deprecated or archived term is rejected on write, because a default is the fastest way to spread a term you have just retired.

When a value must genuinely be COMPUTED rather than chosen, that is what extraction_source / extraction_mode are for. A default answers “what should this be when nothing else says”.

object

kind

required

string

Allowed values: literal context

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

context

Required when kind is context, forbidden otherwise.

• uploading_user — the uploader’s display name. Text types only.
• uploading_team — the name of the team the upload belongs to. Text types only. Not applied when the uploader belongs to no team, or to more than one.
• current_date — creation time. Date types only; a date field gets the day, a datetime the instant.

The set is closed. It carries no “target collection” because POST /assets has no collection in scope — see the 2026-07-31 defaults amendment to ADR 0081.

string

Allowed values: uploading_user uploading_team current_date

Responses

200

The stored override.

One team’s override of a field’s upload default.

object

field_id

required

string format: uuid

team_id

required

string format: uuid

team_slug

required

string

team_name

required

string

default_value

required

A declarative upload default (ADR 0081 §3). Exactly one of two shapes, discriminated by kind, and never an expression:

• literal — a value in whichever value_* member this field’s type uses (the same mapping AssetFieldValueWrite documents). Populating any other member is a 400: the value would land in a column nothing reads.
• context — a name from a closed set the server resolves at creation time. The operator picks from a menu; nothing they write is evaluated.

For select / multi_select / tree, a literal slug must exist in the field’s options and be active. A deprecated or archived term is rejected on write, because a default is the fastest way to spread a term you have just retired.

When a value must genuinely be COMPUTED rather than chosen, that is what extraction_source / extraction_mode are for. A default answers “what should this be when nothing else says”.

object

kind

required

string

Allowed values: literal context

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

context

Required when kind is context, forbidden otherwise.

• uploading_user — the uploader’s display name. Text types only.
• uploading_team — the name of the team the upload belongs to. Text types only. Not applied when the uploader belongs to no team, or to more than one.
• current_date — creation time. Date types only; a date field gets the day, a datetime the instant.

The set is closed. It carries no “target collection” because POST /assets has no collection in scope — see the 2026-07-31 defaults amendment to ADR 0081.

string

Allowed values: uploading_user uploading_team current_date

created_at

required

string format: date-time

updated_at

required

string format: date-time

updated_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