Update Market Cost Price

Replace a market cost price by id with the supplied fields.

Use a marketCostPriceId returned by List Market Cost Prices and send the complete new price values.

Behaviour

This is a full replacement — omitting rrp clears any stored RRP.

The market must be one of your configured markets (400 market_not_configured otherwise).

Currency is derived from the market.

Returns 404 if the id does not exist.

Requires the marketCostPrices:write scope.

put

Authorizations

AuthorizationstringRequired

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

Path parameters

marketCostPriceIdstringRequired

Market cost price identifier (MCP-).

Example: MCP-123e4567-e89b-12d3-a456-426614174000Pattern: ^MCP-[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 Create Market Cost Price (POST /v1/market-cost-prices). Read that operation for usage, permissions and update rules. Required fields and allowed values are defined below; request and response shapes can differ.

marketstring · min: 1 · max: 255Required

Market the price applies to, as configured for the customer.

Example: UK

codestring · min: 1 · max: 255Required

Product/variant code.

Example: A-TM1680/BEPattern: ^[./\\_\-\w]+$

quantityinteger · max: 9007199254740991Required

Quantity tier the price applies to (integer ≥ 0).

Example: 1

costnumberRequired

Cost price in the market currency.

Example: 55.5

rrpnumberOptional

Recommended retail price in the market currency.

Example: 150

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

put/v1/market-cost-prices/{marketCostPriceId}

PUT /v1/market-cost-prices/{marketCostPriceId} HTTP/1.1
Host: admin.mimeeqapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 71

{
  "market": "UK",
  "code": "A-TM1680/BE",
  "quantity": 1,
  "cost": 55.5,
  "rrp": 150
}

{
  "data": {
    "marketCostPriceId": "MCP-123e4567-e89b-12d3-a456-426614174000"
  }
}