Skip to main content
POST
cURL

Chování jednoho a hromadného zápisu

  • Pro vytvoření nebo upsert jednoho klíče odešlete jeden objekt Attribute. Nový klíč vrátí 201; existující kompatibilní klíč vrátí 200 se samotným objektem Attribute.
  • Pro atomický upsert nejvýše 500 Attributes odešlete { "attributes": [...] }. Odpověď je 200 s { "data": [...] }.
  • type existujícího Attribute nelze změnit. U Relation Attribute nelze změnit ani druh relace.
  • Vynechané hodnoty language, image_config a number_config při upsertu zachovají existující metadata.
Když potřebujete jiný typ, použijte nový klíč. POST /attributes/{key}/rename použijte pouze tehdy, když se nemění identita a mění se jen klíč.

Autorizace

Authorization
string
header
povinné

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Tělo

application/json
key
string
povinné
Pattern: ^[a-zA-Z0-9][a-zA-Z0-9_/]*$
label
string
povinné
type
enum<string>
povinné
Dostupné možnosti:
text,
number,
url,
email,
date,
boolean,
richtext,
format,
enum,
tags,
image,
images,
file,
files,
json,
relation
format_output_type
enum<string> | null

Only valid for format Attributes. Defaults to text when omitted or null.

Dostupné možnosti:
text,
number,
boolean,
json,
richtext,
file,
image
enum_values
string[] | null
tags_values
string[] | null
allow_custom_values
boolean
výchozí:true
boolean_config
object | null
number_config
object | null

Only valid for number or Formula-number Attributes. Omit during an upsert to preserve existing metadata.

relation_config
object | null

Relation kind is immutable after creation.

description
string | null
validation
object | null
language
string | null

When omitted during an upsert, the existing language is preserved.

image_config
object

When omitted during an upsert, existing canonical image requirements are preserved. Send an empty object to clear them.

is_reviewed
boolean

Odpověď

Existing single Attribute updated, or bulk upsert completed

id
string<uuid>
povinné
key
string
povinné
label
string
povinné
type
enum<string>
povinné
Dostupné možnosti:
text,
number,
url,
email,
date,
boolean,
richtext,
format,
enum,
tags,
image,
images,
file,
files,
json,
relation
format_output_type
enum<string> | null
povinné

The stored result type produced by a format Attribute. Format formulas execute only in Extraction; Catalog stores the resulting value.

Dostupné možnosti:
text,
number,
boolean,
json,
richtext,
file,
image
enum_values
string[] | null
povinné
tags_values
string[] | null
povinné
allow_custom_values
boolean
povinné

Whether table editors may append missing enum or tag choices.

boolean_config
object | null
povinné
number_config
object | null
povinné

Presentation metadata for number and Formula-number Attributes. Stored and API values remain numeric.

relation_config
object | null
povinné
description
string | null
povinné
validation
object | null
povinné
language
string | null
povinné
image_config
object | null
povinné

Canonical requirements shared by every usage of an image Attribute.

status
enum<string>
povinné

Derived from archive state. Archive and restore remain Dashboard-only.

Dostupné možnosti:
active,
archived
archived_at
string<date-time> | null
povinné
is_reviewed
boolean
povinné
source_id
string<uuid> | null
povinné
external_id
string | null
povinné
source_synced_at
string<date-time> | null
povinné
created_at
string<date-time>
povinné
updated_at
string<date-time>
povinné