Remove Global Option Set Options

Remove a subset of options by id.

Use this to remove selected relationships without replacing the remaining list. It does not delete the referenced resources themselves.

Behaviour

Unknown ids are ignored.

Options you do not list are left untouched.

Requires the globalOptionSets:write scope.

post

Authorizations

AuthorizationstringRequired

API key sent as a bearer token (mk_live_… / mk_test_…).

Path parameters

optionSetIdstringRequired

Global option set identifier (OPT-).

Example: OPT-123e4567-e89b-12d3-a456-426614174000Pattern: ^OPT-[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

Body

Data schema used by Remove Global Option Set Options (POST /v1/global-option-sets/{optionSetId}/options:remove). Read that operation for usage, permissions and update rules. Required fields and allowed values are defined below; request and response shapes can differ.

optionIdsstring[] · min: 1Required

Ids of the options to remove.

Example: ["af77627b-54d7-4039-86dc-599019320634"]

Responses

200

Successful response.

application/json

400

Invalid request data.

application/json

401

Missing or invalid API key.

application/json

403

The API key lacks the required scope (scope_denied), or the operation is not permitted for this account (operation_not_permitted).

application/json

404

Resource not found.

application/json

429

The API key exceeded its request rate (rate_limit_exceeded) or its monthly quota (quota_exceeded). Both carry Retry-After; the RateLimit-* headers accompany rate_limit_exceeded only, since a spent quota says nothing about the bucket.

application/json

500

Internal server error.

application/json

post/v1/global-option-sets/{optionSetId}/options:remove

POST /v1/global-option-sets/{optionSetId}/options:remove HTTP/1.1
Host: admin.mimeeqapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 54

{
  "optionIds": [
    "af77627b-54d7-4039-86dc-599019320634"
  ]
}

{
  "data": {
    "optionSetId": "OPT-123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "displayName": "Chair",
    "description": "Chair",
    "status": "ACTIVE",
    "numberOfOptions": 1,
    "createdAt": "text",
    "modifiedAt": "text",
    "tags": [
      "text"
    ],
    "options": [
      {
        "id": "text",
        "code": "text",
        "name": "Chair",
        "comment": "Chair",
        "priceCode": "text",
        "fbPriceCode": "text",
        "additionalPriceCode": "text",
        "material3dId": "text",
        "arMaterial3dId": "text",
        "additionalPriceCodeQuantity": 1,
        "filters": {
          "<parameterId>": [
            "<valueId>"
          ]
        },
        "metafields": {
          "lead-time-weeks": 10,
          "care-label": "Wipe clean"
        },
        "src": "text"
      }
    ]
  }
}