Skip to content
extensions / Commerce extension
PATCH/api/projects/{project_id}/sales/orders/attributes/{attribute_id}

Update Order Attribute

Update order attribute

Authentication

Requirement
Required
Credential type
Bearer API key
Scopes
Not specified

Permissions

  • Requests are scoped to the target project_id. API-key requests must use a key with an active connection to that project.

Headers

NameRequiredTypeDetails
AuthorizationYesNot specified
Description: Bearer credential used to authenticate the request.

Path Parameters

NameRequiredTypeDetails
project_idYesNot specified
Description: Target project identifier.
attribute_idYesNot specified
Description: Identifier for attribute.

Query Parameters

Request Body

Schema: UpdateOrderAttributeRequest

FieldRequiredTypeDetails
default_labelNostring
Description: Human-readable label.
input_typeNostring
Description: Text value.
is_requiredNostring
Description: Boolean flag.
default_valueNostring
Description: Text value.
placeholderNostring
Description: Text value.
min_text_lengthNointeger
Description: Integer value.
max_text_lengthNointeger
Description: Integer value.
min_dateNostring
Description: Text value.
max_dateNostring
Description: Text value.
allowed_extensionsNostring
Description: Text value.
max_file_sizeNointeger
Description: Integer value.
visible_on_frontendNoboolean
Description: Boolean flag.
hidden_from_customerNoboolean
Description: Boolean flag.
visible_on_backendNoboolean
Description: Boolean flag.
customer_rolesNoJSON
Description: JSON object.
checkout_positionNostring
Description: Text value.
sort_orderNointeger
Description: Integer value.
save_for_futureNoboolean
Description: Boolean flag.
show_on_gridsNoboolean
Description: Boolean flag.
include_in_pdfNoboolean
Description: Boolean flag.
include_in_emailsNoboolean
Description: Boolean flag.
optionsNoJSON
Description: Options payload for this resource.
conditionsNoJSON
Description: JSON object.
is_activeNoboolean
Description: Boolean flag.

Response Body

Example 200 response

json
{
  "id": 1,
  "project_id": 1,
  "attribute_code": "string",
  "default_label": "string",
  "input_type": "string",
  "is_required": "string",
  "default_value": "string",
  "placeholder": "string",
  "min_text_length": "string",
  "max_text_length": "string",
  "min_date": "2026-01-01T00:00:00Z",
  "max_date": "2026-01-01T00:00:00Z",
  "allowed_extensions": [],
  "max_file_size": "string",
  "visible_on_frontend": "string",
  "hidden_from_customer": "string",
  "visible_on_backend": "string",
  "customer_roles": [],
  "checkout_position": "string",
  "sort_order": "string",
  "save_for_future": "string",
  "show_on_grids": [],
  "include_in_pdf": "string",
  "include_in_emails": [],
  "options": [],
  "conditions": [],
  "is_active": "string",
  "created_at": "2026-01-01T00:00:00Z",
  "updated_at": "2026-01-01T00:00:00Z"
}

Errors

400 bad_request404 not_found

Availability

Available in
v0.1.0
Available since
v0.1.0
Implementation
Available
Deprecation
Not specified
Rate limits
Not specified