Create Extra Option Metafield
API operation: Open the endpoint in Scalar
Use POST /business/{business_id}/extras/{extra_id}/options/{option_id}/metafields to create a metafield on an extra option. The operation is ExtraOptionMetafield.register.
The operation requires administrator or business-manager authentication. The controller verifies the business-extra-option chain, applies manager ownership checks, and binds the metafield to option_id. value_type accepts integer, decimal, boolean, text, or json .
This POST creates a metafield. Dynamic metafield keys may require additional validation. See List extra option metafields for the related collection.
OpenAPI reference
Operation: POST /business/{business_id}/extras/{extra_id}/options/{option_id}/metafields
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
business_id | integer | Yes | — |
extra_id | integer | Yes | — |
option_id | integer | Yes | — |
Request body fields
| Name | Type | Required |
|---|---|---|
model | any | Yes |
object_id | integer | Yes |
value | any | Yes |
value_type | string | Yes |
Responses
| Code | Description |
|---|---|
| 200 | OK (Envelope) |
| 400 | Bad Request (ErrorResponse) |
| 401 | Unauthorized |
| 404 | Not Found |
| 429 | Too Many Requests (ErrorResponse) |
| 500 | Internal Server Error (ErrorResponse) |
| 503 | Service Unavailable (ErrorResponse) |