Aktualizovat atribut

PUT

attributes

{key}

Update canonical Attribute metadata

curl --request PUT \
  --url https://app.productlasso.com/api/v1/attributes/{key} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "label": "Product name",
  "language": "en",
  "expected_updated_at": "2026-07-14T10:00:00.000Z"
}
'

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    label: 'Product name',
    language: 'en',
    expected_updated_at: '2026-07-14T10:00:00.000Z'
  })
};

fetch('https://app.productlasso.com/api/v1/attributes/{key}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://app.productlasso.com/api/v1/attributes/{key}"

payload = {
    "label": "Product name",
    "language": "en",
    "expected_updated_at": "2026-07-14T10:00:00.000Z"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

{
  "id": "11111111-1111-4111-8111-111111111111",
  "key": "product_name",
  "label": "Product name",
  "type": "text",
  "format_output_type": null,
  "enum_values": null,
  "tags_values": null,
  "allow_custom_values": true,
  "boolean_config": null,
  "number_config": null,
  "relation_config": null,
  "description": "Public product title",
  "validation": null,
  "language": "en",
  "image_config": null,
  "status": "active",
  "archived_at": null,
  "is_reviewed": true,
  "source_id": null,
  "external_id": null,
  "source_synced_at": null,
  "created_at": "2026-07-01T00:00:00.000Z",
  "updated_at": "2026-07-14T10:00:00.000Z"
}

Poznámky k použití

Vynechaná pole zůstávají beze změny. type a druh Relation jsou neměnné.
Odešlete expected_updated_at z posledního načtení, abyste nepřepsali novější změnu. Zastaralá hodnota vrátí 409 s kódem stale_write a polem current_updated_at.
Attribute spravovaný zdrojem odmítne změnu vlastněnou zdrojem, pokud ve stejném požadavku nenastavíte detach: true.
Prázdný image_config vymaže kanonické požadavky na obrázek. number_config: null vymaže metadata zobrazení čísel.

Zastaralé pole těla key Attribute nepřejmenuje. Použijte samostatný endpoint pro přejmenování.

Autorizace

Authorization

string

header

povinné

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

Parametry cesty

key

string

povinné

Canonical Attribute key.

Tělo

application/json

key

string

zastaralé

Retained for request compatibility but does not rename the Attribute. Use the rename operation.

label

string

format_output_type

enum<string> | null

Only valid for format Attributes. Omit to preserve the current output type; null resets it to text.

Dostupné možnosti:

text,

number,

boolean,

json,

richtext,

file,

image

enum_values

string[] | null

tags_values

string[] | null

allow_custom_values

boolean

boolean_config

object | null

number_config

object | null

Only valid for number or Formula-number Attributes. Send null to clear; omitted fields remain unchanged.

Show child attributes

relation_config

object | null

Relation configuration may change, but relation kind is immutable.

description

string | null

validation

object | null

language

string | null

Omitted fields remain unchanged.

image_config

object

Omitted fields remain unchanged. Send an empty object to clear canonical requirements.

Show child attributes

is_reviewed

boolean

detach

boolean

Detach a source-managed Attribute before editing source-owned content.

expected_updated_at

string<date-time>

Optional compare-and-set revision. Refetch after a stale_write response.

Odpověď

Updated Attribute

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.

Show child attributes

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.

Show child attributes

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é

Update canonical Attribute metadata

curl --request PUT \
  --url https://app.productlasso.com/api/v1/attributes/{key} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "label": "Product name",
  "language": "en",
  "expected_updated_at": "2026-07-14T10:00:00.000Z"
}
'

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    label: 'Product name',
    language: 'en',
    expected_updated_at: '2026-07-14T10:00:00.000Z'
  })
};

fetch('https://app.productlasso.com/api/v1/attributes/{key}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://app.productlasso.com/api/v1/attributes/{key}"

payload = {
    "label": "Product name",
    "language": "en",
    "expected_updated_at": "2026-07-14T10:00:00.000Z"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

{
  "id": "11111111-1111-4111-8111-111111111111",
  "key": "product_name",
  "label": "Product name",
  "type": "text",
  "format_output_type": null,
  "enum_values": null,
  "tags_values": null,
  "allow_custom_values": true,
  "boolean_config": null,
  "number_config": null,
  "relation_config": null,
  "description": "Public product title",
  "validation": null,
  "language": "en",
  "image_config": null,
  "status": "active",
  "archived_at": null,
  "is_reviewed": true,
  "source_id": null,
  "external_id": null,
  "source_synced_at": null,
  "created_at": "2026-07-01T00:00:00.000Z",
  "updated_at": "2026-07-14T10:00:00.000Z"
}

Přehled

Vyhledávání

Obohacení dat

Tabulky

Řádky

Obohacení

Schémata

Atributy

Soubory

Slovník

Kredity

Produktová analytika

Katalog

Webhooky katalogu

Aktualizovat atribut

Poznámky k použití

Autorizace

Parametry cesty

Tělo

Odpověď

​Poznámky k použití

Autorizace

Parametry cesty

Tělo

Odpověď

Poznámky k použití