Skip to content
Artist Alley

Create a new field definition (admin)

POST
/fields

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
object
code
required
string
>= 1 characters <= 64 characters /^[a-z][a-z0-9_]*$/
label
required
string
>= 1 characters <= 200 characters
description
string
type
required
string
Allowed values: text longtext rich_text number boolean date datetime select multi_select tree reference
subject_kind

What the field describes. Defaults to asset for backwards compatibility.

string
default: asset
Allowed values: asset collection
options
object
key
additional properties
any
required
boolean
searchable
boolean
default: true
applies_to
Array<integer>
field_set_id
string format: uuid
nullable
read_capability
string
nullable
write_capability
string
nullable
display_order
integer
default: 100
display_group
string
default: general
source
object
key
additional properties
any

Responses

Section titled “ Responses ”

201

Section titled “201 ”

Field created

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

500

Section titled “500 ”

Unexpected server error

object
error
required

Human-readable error summary

string
Example
the request could not be completed