Skip to content
Artist Alley

Update a field definition (admin)

PATCH
/fields/{id}

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required
string format: uuid

Request Body required

Section titled “Request Body required ”

Partial update; only present fields are touched.

object
label
string
>= 1 characters <= 200 characters
description
string
options
object
key
additional properties
any
required
boolean
searchable
boolean
applies_to
Array<integer>
field_set_id
string format: uuid
nullable
read_capability
string
nullable
write_capability
string
nullable
display_order
integer
display_group
string
source
object
key
additional properties
any
status
string
Allowed values: active deprecated archived
deprecated_replacement_id
string format: uuid
nullable

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Updated

object
id
required
string format: uuid
code
required

Federation-stable slug. Globally unique.

string
label
required
string
description
string
type
required
string
Allowed values: text longtext rich_text number boolean date datetime select multi_select tree reference
subject_kind
required

What the field describes. asset definitions apply to individual assets; collection definitions apply to whole collections. One row is one or the other — operators who want a field on both kinds create two rows.

string
Allowed values: asset collection
options

Type-dependent constraints / values. Shape per ADR 0012.

object
key
additional properties
any
required
required
boolean
searchable
required
boolean
applies_to
required

Resource type refs this field applies to. Empty = all. Ignored when subject_kind = ‘collection’.

Array<integer>
field_set_id
string format: uuid
nullable
read_capability
string
nullable
write_capability
string
nullable
display_order
required
integer
display_group
required
string
source

Auto-extraction source, e.g. {“type”:“exif”,“tag”:“DateTimeOriginal”}.

object
key
additional properties
any
extraction_source

CanonicalField the metadata-extraction pipeline writes into this field. Empty = no extraction (the field stays operator-managed). Edited via the dedicated PUT …/extraction endpoint.

string
extraction_mode

Write behaviour when extraction has a value. Empty = default (skip_if_set).

string
Allowed values: "" skip_if_set replace append prepend
status
required
string
Allowed values: active deprecated archived
deprecated_replacement_id
string format: uuid
nullable
created_at
required
string format: date-time
updated_at
required
string format: date-time

400

Section titled “400 ”

Malformed request

object
error
required

Human-readable error summary

string
Example
the request could not be completed

401

Section titled “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

Section titled “403 ”

Authenticated but missing required capabilities

object
error
required

Human-readable error summary

string
Example
the request could not be completed

404

Section titled “404 ”

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed